# Release Sets

{% hint style="info" %}
This feature requires a license. Learn more about [Workflow's licensing model](https://umbraco.com/products/umbraco-workflow).
{% endhint %}

Release Sets are collections of [Alternate Versions](https://docs.umbraco.com/umbraco-workflow/alternate-versions/alternate-versions), where each version can be scheduled independently. Release Sets provides a holistic overview of scheduled content and enables building and managing content schedules to drive digital campaigns.

## Working with Release Sets

1. Ensure the User Group permissions are set to allow appropriate access.

<div align="center"><figure><img src="https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-d1f3a21956f81d08d9490a424688978e629fbe89%2Frelease-set-permissions.png?alt=media" alt=""><figcaption></figcaption></figure></div>

2. Navigate to the **Release Sets** dashboard in the **Content** section.

<figure><img src="https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-e5a85b8752b6915b5f8d5063c5a6f5be74ccde1c%2Frelease-sets-dashboard.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Click the **Create** button to open a workspace modal to create a new set.

<figure><img src="https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-a1be9003451b77fab3aeb67a701402baea43c98f%2Frelease-set-workspace-editor.png?alt=media" alt=""><figcaption></figcaption></figure>

A Release Set is comprised of document versions and (optionally) tasks. Tasks are like to-dos that should be tracked alongside the Release Set, but are not necessarily CMS activities.

For example, a task might be to finalize digital advertising. It is not a CMS activity, but it is a requirement that must be met before publishing the Release Set.

### Adding documents

1. Click the **Add document** button.
2. Select the document node from the picker.
3. Add or create a new version of the selected document in the version editor.

<figure><img src="https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-3d7963b0ed1b7b527ee2cbe0e4676068193c951f%2Fversions-editor.png?alt=media" alt=""><figcaption></figcaption></figure>

Adding an existing version opens the version picker. Creating a new version opens the [Alternate Version](https://docs.umbraco.com/umbraco-workflow/alternate-versions/alternate-versions) workspace editor.

<figure><img src="https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-5add83267a8f3f7f614dd921f4a3ab2e30234c37%2Fversion-picker.png?alt=media" alt=""><figcaption></figcaption></figure>

Add an existing version or create a version to display it in the version editor.

<figure><img src="https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-16a566571e8712acd5cd46b1b81a16033cd86f34%2Fversion-editor-2.png?alt=media" alt=""><figcaption></figcaption></figure>

4. Enter the date and time in the **Publish at** field.
5. Click **Schedule publish** to schedule the selected version.

<figure><img src="https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-dad3f44f68dfe605ee9c87f29abc01e53b2df6f9%2Fversion-scheduling.png?alt=media" alt=""><figcaption></figcaption></figure>

You can add multiple versions of the same document and schedule them in sequence.

<figure><img src="https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-88aa24c9589a8d40d75fe882edd0fd5506efec89%2Fversion-editor-3.png?alt=media" alt=""><figcaption></figcaption></figure>

After submitting the modal, the updated versions are displayed in the overlay.

The documents list shows the selected documents, while the calendar shows the Release Set and its components.

<figure><img src="https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-37abfbbd2e9c2c5cd6e46ac9a7ae23a4a7de786b%2Frelease-set-overview.png?alt=media" alt=""><figcaption></figcaption></figure>

6. Select a day in the calendar to display the scheduled content changes for that date.

<figure><img src="https://2308063626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihjXeb5EgYW8vXPfbxLI%2Fuploads%2Fgit-blob-cac19ed04811110e45cb5cc0669cca9fd1836ce6%2Fcalendar-day.png?alt=media" alt=""><figcaption></figcaption></figure>

7. Click the **Add** button in the calendar dialog to add items to the Release Set.

### Publishing a Release Set

A Release Set can be published immediately or scheduled for future publication. To publish a Set, all assigned versions and tasks must be either `Ready to publish` (versions) or `Complete` (tasks). If all components in the Set are in the required status, it can be published by a user with the appropriate permission.

Publishing content within the Release Set is managed by a recurring hosted service, similar to scheduled content publishing.

As publishing progresses, each document version is promoted to be the current backoffice draft, and then published as normal. A version of the original backoffice draft is preserved as an Alternate Version and can be republished or edited in the future.

When a Release Set has no further changes to publish, the status is updated to `Complete`. The Set can then be deleted, or updated and republished. Content published within the Set is preserved and can be further edited or included in a new Release Set.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-workflow/release-sets/release-sets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
