Skip to main content

Releases

GrowthThis feature is available with a Growth plan. EnterpriseThis feature is available with an Enterprise plan. TeamThis feature is available with a Strapi Cloud Team plan.

The Releases feature enables content managers to organize entries into containers that can perform publish and unpublish actions simultaneously. A release can contain entries from different content types and can mix locales.

Identity Card of the Feature

Plan: CMS Enterprise Plan or Cloud Team plan.
Role & permission: Administrator role in the project's admin panel.
Activation: Available by default, if required plan.
Environment: Available in both Development & Production environment.

List of ReleasesList of Releases

Configuration​

To be able to include your content in releases, and to schedule and publish those releases, you must first create them. You can also modify the releases' default timezone to use when scheduling a publication, as well as deleting releases that are obsolete or irrelevant.

Choosing default timezone​

Path to configure the feature: Settings

  1. Click on the Default timezone dropdown list and choose the default timezone to use.
  2. Click Save.
Release settingsRelease settings

Creating a release​

Path to configure the feature: Releases

  1. Click the New Release button in the upper right corner.
  2. Give the release a name.
  3. (optional) If you want to schedule the release publication instead of publishing the release manually, check the Schedule release checkbox and define the date, time, and timezone for publication.
  4. Click the Continue button.
Tip

Your releases can be renamed afterwards, by editing the release using the then Edit buttons.

Adding a new releaseAdding a new release

Deleting a release​

Path: Releases

Deleting a release will only delete the release itself, but not the content-type entries included in the release.

  1. Click on the button in the top right corner of the admin panel.
  2. Select Delete.
  3. In the confirmation dialog, click Confirm.

Usage​

Path to use the feature: Releases and Content Manager

Caution

Since publishing an entry with a release means turning a draft entry into a published entry, Releases will not work if Draft & Publish is disabled for the content-type.

Including content in a release​

Prerequisites
  • Before entries can be added to a release, you must create a release from the Releases page.
  • Adding content to a release requires the appropriate permissions for the Content-Releases plugin (see configuring administrator roles).

One entry at a time​

Path: Edit view of the Content Manager

  1. Click on in the Entry area on the right side of the interface.
  2. In the list, click on the Add to release button.
  3. Select which release to add this entry to.
  4. Click on the Publish or Unpublish button depending on whether you want the entry to be published or unpublished when the release itself is published, then click Continue.

The Releases box on the right should show which release(s) the entry is included in.

Info

If Releases scheduling is enabled and the entry is added to a scheduled release, the release date and time will also be displayed.

Multiple entries at a time​

Path: List view of the Content Manager

  1. Select which entries you want to add by ticking the box on the left side of the entries' record.
  2. Click on the Add to release button located above the header of the table.
  3. In the modal, select which release to add these entries to.
  4. Click on the Publish or Unpublish button to decide whether these entries will be published or unpublished when the release is published, then click Continue.
Including content in a releaseIncluding content in a release

Removing content from a release​

Path: Edit view of the Content Manager

  1. In the Releases box in the right sidebar, click on below the name of the release.
  2. Click the Remove from release button.

Scheduling a release​

Path: Releases

Releases can be published manually or scheduled to be automatically published at a given date and time, with the timezone of your choice.

You can schedule a release:

To schedule an existing release, while on a release page:

  1. Click on the button in the top right corner of the admin panel.
  2. Select Edit.
  3. In the modal, check the Schedule release checkbox.
  4. Select a date, time, and timezone for the release to be published.
  5. Click Save.
Release schedulingRelease scheduling

Publishing a release​

Path: Releases

Publishing a release means that all the actions (publish or unpublish) defined for each entry included in the release will be performed simultaneously. To publish a release, click the Publish button in the top right corner of the admin panel.

The Status column displays the status of each entry:

  • Already published: the entry is already published and publishing the release will not affect this entry
  • Already unpublished: the entry is already unpublished, and publishing the release will not affect this entry.
  • Ready to publish: the entry is ready to be published with the release
  • Ready to unpublish: the entry is ready to be unpublished with the release
  • Not ready to publish: the entry cannot be published because some fields are incorrectly filled, or it hasn't reached the required stage for publishing. In this case, the release will be indicated as Blocked until all issues have been fixed.

If some of your entries have a status, click the and the Edit the entry button to fix the issues until all entries have the status. Note that you will have to click on the Refresh button to update the release page as you fix the various entries issues.

Caution

Once a release is published, the release itself cannot be updated. You can not re-release that specific release with the same group of entries with some modifications; you must create another release.

Release publishRelease publish