Working with Assets Contentstack allows you to upload any files (images, videos, PDFs, audio files, and so on) and store it in your repository for future use. This repository of uploaded files is called assets. Once a file has been uploaded to assets, it can be attached to any entry. This is especially useful when you want to use certain assets in multiple entries.

Upload a New Asset

To upload a new asset, go to the Assets screen, and click the New Asset link located on the top-right corner of the page.

Note:Currently, you can upload assets that have sizes less than or equal to 700 MB.

This will open a file explorer that allows you to upload any file. Once the file is uploaded, you can choose to Save or Publish it.

Each asset is identified uniquely with a separate API interface key. So you can upload multiple files with the same name or the same file multiple times.

Tutorial Video

Let's upload a sample asset (image file) to our stack.


Edit an Asset

Editing an asset means replacing an existing file with a new one. To replace an existing asset, click Change File and upload a file of your choice. If you edit and publish an asset, it will replace the existing asset with the new one on all published web pages that contained the earlier asset.

Tutorial Video

We will now replace the uploaded sample image with a new image. We will also add a tag to this asset.


Publish an Asset

After uploading a new asset, you can publish it to one or more servers of your choice in the defined site language. When you click the Publish link, you will see a dialog box that contains the following options.


Choose one or more publishing environments. These are the servers to which the entry will be sent for publishing.


By default, English (United States) is selected as the language for publication. Choose another language to publish the asset for other locale.

Publish At

You can publish the asset either immediately or at a later date/time. If you select the Publish Later option, select the date, time, and timezone for publishing the asset.

Tutorial Video

Let's publish the uploaded asset to development environment.


Unpublish an Asset

You can remove an asset from an environment by unpublishing it. To unpublish an existing asset, edit the asset, and click the Unpublish link. Select the environment you wish to remove the asset from. If you wish to automatically unpublish the entry at a later date/time, select Unpublish At and select the date, time, and timezone for unpublishing the entry.

Tutorial Video

We will now unpublish the asset that we had published in the previous step.


Filter Assets

You can filter assets by their type (audio, video, docs, image, PDF, and so on), publish status (draft, published), and tags (if any). This helps you filter or search your assets easily.

Tutorial Video