Add Entry/Asset to a Release

After creating a release, you can start adding entries or assets to it.

Additional Resource: Refer to the bulk add to release document to add multiple entries to a release.

To add an entry to a release, log in to your Contentstack account and perform the following steps:

1. Go to your stack, then click the “Entries” icon on the left navigation panel and select an existing entry.
2. Click the horizontal ellipsis at the bottom of the entry editor and click Add to Release.
3. In the Add to Release modal, either select an existing release or create a new one by clicking the "+" icon.

   Note: For older releases, you may receive a warning message indicating that references will not be included, or that only one level of nesting is published/unpublished for single items. To avoid this, create a new release or clone an older release.

4. Select the language(s) in which you want to deploy the entries. Specify the Publish or Unpublish action you want to perform and click Add.
5. On the Add Reference(s) to Release modal, nested references (entries and assets) linked to the entry up to the configured Nested Reference Publishing (NRP) depth of the organization are listed.
   Note:

   • Nested references up to a default depth of 5 levels are included for both single and bulk add to release actions. This limit may vary based on your organization’s plan.
   • Click the “Edit entry in new tab” icon to make changes to the referenced entries.
   • This modal appears only when a single entry with references is added to a release.
6. Click Add With References to include all referenced entries or Add Without References to add only the selected entry.

   Note: You can view the release action logs in the Stack Bulk Task Queue.

To add an asset to a release, log in to your Contentstack account and perform the following steps:

1. Go to your stack, then click the “Assets” icon in the left navigation panel and select an existing asset.
2. Click the horizontal ellipsis at the top of the asset details page and click Add to Release.
3. In the Add to Release modal, either select an existing release or create a new one by clicking Create New Release.
4. Select the languages in which you want to deploy the assets.

   Note: Assets do not support localization, but selecting language(s) determines the locales in which the asset will be available.

5. Click Add for Publishing to publish the asset or Add for Unpublishing to unpublish the asset.

   Note: You can view release action logs in the Stack Bulk Task Queue.

After successfully adding items to a release, you can deploy the release to an environment.

Note: Before deployment, you can update release items to their latest versions to ensure the most current content is included.

To add entries or assets to a release via API, refer to the Add a single item to a Release and Bulk Add to Release API requests.