---
title: "[Create and Manage Releases NEW] - Add Entry/Asset to a Release"
description: Instructions for adding entries or assets to a release, including reference handling and API links.
url: https://www.contentstack.com/docs/content-managers/create-and-manage-releases/add-entry-asset-to-a-release
product: Contentstack
doc_type: how-to
audience:
  - content-managers
  - developers
version: NEW
last_updated: 2026-03-25
---

# [Create and Manage Releases NEW] - Add Entry/Asset to a Release

This page explains how to add entries and assets to a release in Contentstack, including how referenced items are handled and where to find related API operations. It is intended for content managers (and developers using the API) who need to prepare items for deployment via releases.

## Add Entry/Asset to a Release

After creating a [release](/docs/content-managers/create-and-manage-releases/about-releases/), you can start adding entries or assets to it.

**Additional Resource:** Refer to the [bulk add to release](/docs/content-managers/author-content/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](https://www.contentstack.com/login/) and perform the following steps:
- Go to your [stack](/docs/developers/set-up-stack/about-stack), then click the “Entries” icon on the left navigation panel and select an existing entry.
- Click the horizontal ellipsis at the bottom of the entry editor and click **Add to Release**.
- 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](/docs/content-managers/create-and-manage-releases/create-a-new-release) a new release or [clone](/docs/content-managers/create-and-manage-releases/clone-a-release) an older release.
- 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**.
- 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)**](/docs/content-managers/publish-content/about-nested-reference-publishing) 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.
- 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](/docs/content-managers/author-content/stack-bulk-task-queue).

## Add an Asset to a Release

To add an asset to a release, log in to your [Contentstack account](https://www.contentstack.com/login/) and perform the following steps:
- Go to your [stack](/docs/developers/set-up-stack/about-stack), then click the “Assets” icon in the left navigation panel and select an existing asset.
- Click the horizontal ellipsis at the top of the asset details page and click **Add to Release**.
- In the **Add to Release** modal, either select an existing release or create a new one by clicking **Create New Release**.
- 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.
- 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](/docs/content-managers/author-content/stack-bulk-task-queue).

After successfully adding items to a release, you can [deploy](/docs/content-managers/create-and-manage-releases/deploy-a-release) the release to an environment.

**Note:** Before deployment, you can [update release items to their latest versions](/docs/content-managers/create-and-manage-releases/update-release-items-to-their-latest-versions) to ensure the most current content is included.

## API Reference

To add entries or assets to a release via API, refer to the [Add a single item to a Release](/docs/developers/apis/content-management-api#add-a-single-item-to-a-release) and [Bulk Add to Release](/docs/developers/apis/content-management-api#bulk-add-to-release) API requests.

## Common questions

### How do I add multiple entries to a release at once?
Use the **bulk add to release** document: [bulk add to release](/docs/content-managers/author-content/bulk-add-to-release).

### Why do I see a warning when adding items to older releases?
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.

### How many levels of nested references are included when adding an entry?
Nested references up to a default depth of **5 levels** are included for both single and bulk add to release actions, and the limit may vary based on your organization’s plan.

### Where can I view release action logs?
You can view the release action logs in the [Stack Bulk Task Queue](/docs/content-managers/author-content/stack-bulk-task-queue).