🎤 Builder Talk: The Story Behind Lady Gaga’s Digital Experience – Register now

Content Releases user guide

Content Releases allow teams to organize and schedule updates across multiple documents.

Content Releases allow teams to organize and schedule updates across multiple documents. Teams can plan, preview, and validate significant changes in advance, ensuring seamless and conflict-free content deployment.

Content Releases provide several key benefits:

  • Coordinate Updates: Simultaneously manage and publish updates across multiple pages and channels, ensuring consistency.
  • Reduce Manual Effort and Risk: Automate scheduling to minimize manual tracking and prevent errors or conflicting changes.
  • Gain Confidence with Previews and Validation: Preview and validate scheduled releases to guarantee readiness before going live

For developer documentation on how to configure, integrate, and interact with Content Releases programmatically, go here:

Paid feature

Content Releases is available for all projects on the Growth plan and up. Limits are set at the organization level.

Before you begin

Content Releases requires that your studio and plugins be up to date. If you're experiencing issues using Content Releases, check with your administrator and direct them to the Studio configuration.

The Content Releases workflow

Content Releases introduces the concept of a release. Releases are a way to group multiple document changes together into a single unit that can be previewed, validated, scheduled, and published as one.

The most basic workflow is as follows:

  1. Create a release.
  2. Add documents to a release to create new document versions.
  3. Make changes to documents.
  4. Publish the release.

The document view

The document screen

When you're working on a release, the document screen displays details about versions of the document. Document version names correspond to release names. Published and drafts are always enabled, but additional versions are displayed as documents are added to releases.

Select a version name to switch between versions. Right click the names to copy versions between releases, or discard a version.

Protip

The release color highlights the global toolbar and document list to remind you that you're working on a specific release.

The releases view

The releases screen

The releases screen displays any upcoming releases. Bold dates in the calendar indicate releases with date estimates. You can also see the number of changes in each release, and warnings if there are validation errors.

Release layering

Release layering is the concept of displaying documents based on where a release falls in the release timeline and which perspective is active.

This allows editors to preview document changes across multiple releases. You can see a simplified version of this in how drafts override published documents in Presentation.

In Studio, release layering works on a timeline. The type and time of release indicates where a release falls on the timeline. You already know published and draft, but there are also as soon as possible (ASAP), timed, and undecided.

The layer follows this order, starting at 1 and adding changes.

  1. Published
  2. Draft
  3. As soon as possible (ASAP)
  4. Timed (e.g., a set time in the future)
  5. Undecided

When viewing a release with an undecided release time, you will see all changes from drafts, ASAP releases, and timed releases stacked atop published documents—plus any changes on the undecided release(s). These views of your content in Studio are the global perspective.

Documents override their earlier versions

The global view and document list will show changes across releases based on the layering order, but multiple changes in the same document across releases will be overridden by the highest selected layer level.

Global perspective

The global perspective is your view into the state of all documents at a point in time. By selecting a release, you're viewing not only its changes, but all changes in prior releases. You can hide individual releases form view, or view just the Published perspective.

Gotcha

Does it seem like all documents are read-only? You might be in the Published perspective. Select Draft or a release from the document screen to make changes to a document.

How do drafts fit in with releases?

You can work directly on a draft and publish it without needing to create a release. You can also work on a draft, then copy it to a release.

One important thing to keep in mind. Publishing a release will not reset a draft. If you created a draft and made changes, then copied it to a release, that draft still exists. There are two ways you can keep these leftover drafts in check:

  • If you know you're working on a release, start the draft in the release. This way a draft document is never created.
  • After copying a draft to a release, return to the draft document and discard the draft version.

Create a release

To add new documents and changes to a release, you first need to create a release.

Select the release dropdown
  1. Locate the calendar icon in the top right corner of the toolbar.
  2. Select the down arrow icon to reveal a list of releases.
  3. Select new release to create a new release.
    1. Select an approximate time of release.
    2. Enter a release title (optional).
    3. Enter a description for the release (optional).
Create a new release

You can change these values later by navigating to the release on the Releases screen.

Protip

You can also create a release from the Releases screen by selecting New release in the top right corner.

Add a document to a release

There are two ways to add a document to an existing release.

On the main releases screen

  1. Navigate to the releases screen by selecting the calendar icon in the top right of Studio.
  2. Select the release name to navigate to its detail screen.
  3. At the bottom of the list of documents, select Add document.
  4. Search for and select a document.

On the document screen

  1. Ensure you are in a release perspective by pinning a release. You'll know you've pinned a release if the release name is next to the calendar icon in the toolbar.
  2. In a document's editor view, select the Add to release button in the top bar. This button and bar should match the color scheme associated with the release perspective.

Once a document is part of a release, you'll be able to edit the release version by ensuring the release is selected at the top of the document.

Remove a document from a release

Removing a document from a release discards any changes unique to that version. This action won't remove the document from other releases.

There are three ways to remove a document from a release.

On the main releases screen

  1. Select the release name to navigate to its details screen.
  2. Identify the document you wish to remove and select the "..." icon to reveal additional options.
  3. Select Discard version and confirm the selection when prompted.

On the document screen

  1. Confirm you are in the perspective for the desired release. You should see the release name next to the calendar icon in the toolbar, as well as the highlighted release name at the top of the document.
  2. At the bottom right of the document screen, select the "..." icon.
  3. Select Discard version and confirm the selection when prompted.

or

  1. On the document header, find the chip with the version you wish to discard.
  2. Right click the chip, a context menu will open.
  3. Select Discard version and confirm the selection when prompted.

Copy a document from one release to another

You can copy a document version to a different release from the document view.

Right click a version name to reveal the version action menu.
  1. Navigate to the document you want to copy.
  2. Right click the release name you want to copy from.
  3. Hover over "Copy version to".
  4. In the popover menu, select the destination release.

Unpublish a document as part of a release

Sometimes you want a release to unpublish, or remove a live document. This converts a published document back to a draft once the release is published.

  1. Add the document to a release.
  2. In the bottom right corner of the document screen, select the "..." icon.
  3. Select Unpublish when releasing and confirm the selection when prompted.
Unpublish when releasing

Discard a draft version

To discard a document version, follow the steps listed in Remove a document from a release.

To discard changes from the Draft version, select the "..." icon at the bottom right of the document screen and select Discard changes.

Publish a release

After creating a release, you can choose to publish it on-demand or schedule a publish.

  1. Navigate to the release screen for the release you want to publish.
  2. Select Publish all documents.

Schedule a release

To schedule a release, first set a release time and date. You can do this when creating a release, or by selecting the release time label and selecting At time from the release screen. You can adjust this time later if needed.

Set an estimated release time

Next, select Schedule for publishing in the bottom left of the release screen.

Schedule for publishing

Confirm the release time and date, then select Yes, schedule for publishing.

Gotcha

Setting a release time alone does not schedule the release. You must set a time, and schedule the release using the Schedule for publishing button.

Unschedule a release

To unschedule a release, select the Unschedule button in the bottom right of the release screen.

Archive a release

Archived releases are releases that were published, but you can also archive unpublished releases to preserve them for future reference.

Gotcha

You cannot archive a scheduled release. First, unschedule it. Then follow the steps below to archive the release.

There are two ways to manually archive a release.

On the main releases screen

  1. Select the "..." icon for the release you want to archive.
  2. Select Archive release.

On the individual release screen

  1. In the bottom right, next to the Publish / Schedule button, select the "..." icon.
  2. Select Archive release.

Unarchive a release

You may unarchive an archived, unpublished release. Published releases cannot be unarchived.

There are two ways to manually unarchive a release.

On the main releases screen

  1. Select the "..." icon for the release you want to unarchive.
  2. Select Unarchive release.

On the individual release screen

  1. In the bottom right select the "..." icon.
  2. Select Unarchive release.

Change the release order

Release order is determined by when the release will be live, with exceptions for ASAP and Undecided.

  • ASAP releases come first, in order of creation.
  • Dated releases come next, ordered by date.
  • Undecided releases come last, ordered by creation.

To change the order of a release, change the date and time associated with it.

Pin a release (global perspective)

Pinning a release sets the global perspective in Studio. This is indicated by the color change in the toolbar, as well as the highlighted release name throughout Studio.

You can only pin one release at a time.

A pinned release highlights the Studio experience

There are three ways to pin a release.

Anywhere in Studio

  1. In the top toolbar, select the dropdown arrow next to the calendar icon. If a release is currently pinned, the arrow will display next to the pinned release.
  2. Select the release name for the release.

On the main releases screen

  1. Locate the release to pin.
  2. Select the pin icon to the left of the release name.

On the Release detail screen

  1. Navigate to the release that you wish to pin.
  2. Select the pin icon on the top left, above the release name

View Release history

You can view past releases, including unpublished ones, from the Archived tab on the main releases screen.

Edit properties of an existing release

You can edit the name, estimated release time, or description directly on the release screen.

To change the title or description, select the field and begin typing.

To change the estimated publish time, select the release time label and choose a new time.

Gotcha

You can edit the name and description of scheduled releases, but in order to change the schedule date or time you first need to unschedule the release.

Hide releases from the global perspective view

When viewing a future release, you can choose to hide earlier releases from the global perspective view. This lets you hide document changes made by specific releases, while still previewing a subset of changes across releases.

Toggle release visibility
  1. To hide versions from a specific release, first set your global perspective.
  2. In the release dropdown view, select the open eye icon next to any release you wish to hide.
  3. To reveal a hidden release, select the closed eye icon.

Preview releases in Presentation

If your team has enabled Presentation, you can preview a release by pinning it and then selecting the Presentation tool in Studio.

Keep the release layering concept in mind, and use the hide release feature to customize your preview perspective.

Was this article helpful?