Skip to main content

Managing a release EnterpriseThis feature is available with an Enterprise licence. TeamThis feature is available with a Strapi Cloud Team plan.

Adding entries to a release allow viewing them altogether on a single page.

Release detailsRelease details

From a release page, you can:

  • edit the release, to update its name or schedule it, or delete the release,
  • decide whether an entry will be published or unpublished with the release,
  • and publish the release.
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.

Editing a release​

You can rename a release. To do so, while on a release page:

  1. Click on the More icon button in the top right corner of the admin panel.
  2. Select Edit icon Edit.
  3. In the modal, change the name of the release in the Name field.
  4. Click Continue to save the change.

Scheduling a release​

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 More icon button in the top right corner of the admin panel.
  2. Select Edit icon 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

Choosing how entries are grouped​

A release page can display entries either grouped by locale, content-type, or action (publish or unpublish). To change how entries are grouped, click the Group by … dropdown and select an option from the list.

Publishing or unpublishing entries​

A release includes multiple entries. You can set the state of each entry with the Publish and Unpublish action buttons. When the release itself is “published” then the desired actions will be simultaneously performed on each entry.

Removing entries from a release​

Entries can be removed from a release. To do so, click the More icon at the end of the row of an entry and select the Remove from release button.

Publishing a release​

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:

  • Success icon Already published: the entry is already published and publishing the release will not affect this entry
  • Success icon Ready to publish: the entry is ready to be published with the release
  • Fail icon "[field name] is required", "[field name] is too short" or "[field name] is too long": the entry cannot be published because of the issue stated in the red warning message. In this case, the release will be indicated as Blocked until all issues have been fixed.

If some of your entries have a Fail icon status, click the More icon and the Edit the entry button to fix the issues until all entries have the Success icon 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.

Deleting a release​

You can delete a release. Deleting a release will only delete the release itself, but not the content-type entries included in the release. To delete a release, while on the release page:

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