Working with Assets

Built.io 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

You can start adding assets directly into your default location or you can create folders and upload your assets within it.

To upload a new asset, you need to perform the following steps:

  1. Click on the 'Assets' link in the top navigation to view the list of available assets.
  2. Click on the 'New Asset' tab located on the top-right corner of the page.
  3. Click on New Asset.png

  4. You will be led to the 'Add New Asset' upload page where you can either drag-and-drop an asset file or browse for one in your local system.
  5. Upload asset page.png

    Note: Currently, you can upload an asset that does not exceed 700 MB.

  6. When you drag-and-drop an image, it's selected directly; however, if you click on 'Browse file', a file explorer opens that will allow you to select any file from your file system.
  7. Once the file is selected, you will see a preview of the file. Click 'Save' to finally upload it, or click 'Publish' to publish the asset.

When the file is uploaded, the page displays the details of the uploaded file. The details include 'Filename', 'Unique Id', 'File URL', 'Folder', 'Type', 'File Size', 'Created', and 'Modified'.

By clicking on the file URL, you will be able to copy the URL of the uploaded file.

Copy asset URL.png

Also, you can change the folder location of the file (by default, your file gets uploaded to the folder in which you currently are) by clicking on the 'change' link beside the 'Folder' parameter.

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

Edit an Asset

Editing an asset means replacing an existing file with a new one. To replace an existing asset, perform the following steps:

  1. Click on the asset that you wish to replace. This will open the modal that displays the details of the particular asset.
  2. On the ‘Edit Asset’ page, click on the 'Change file' link on the file preview image. This will let you browse through your file system and upload a new file of your choice.
  3. Edit Asset.png

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.

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.

Environment

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

Language(s)

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.

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.

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.

Create a Folder

To organize assets, you can create folders in the Assets section of Built.io Contentstack. Also, you can maintain nested folder structure, which means you can create folders within folders, going up to the depth of five levels.

To create an asset folder, perform the following steps:

  1. Click on the 'Assets' link in the top navigation to view the list of available assets.
  2. Click on the 'Create folder' icon at the top right-hand side of the page.
  3. Create folder button.png

  4. This will open the 'Create a new folder' modal where you need to enter a name for your folder, for example, 'Project'.
  5. Click on 'Create'. You will see a new folder named 'Project' as the first item on the Assets page.
  6. Folder created.png

  7. Click on the folder to open it.
  8. To start adding assets into the folder, click on the ’Add asset’ button on the center or at the top right-hand side corner of the page. For more details on how to add assets, refer the 'Upload a New Asset' section.

Add asset in new folder.png

Note: Maximum 300 folders can be created per stack.

Rename a Folder

To rename a folder, perform the steps given below:

  1. Click on the 'Assets' link in the top navigation to view the list of available assets.
  2. When you hover on the folder that you wish to rename, on the extreme right side, you will notice three vertical dots which is the 'More Options' icon. Click on this icon and select 'Rename' to provide a suitable name to your asset folder.
  3. Rename folder.png

  4. Finally, click on 'Save'. 

Move a Folder

You can move folders to another location or inside another folder to create a nested folder structure. To do so, perform the steps given below:

  1. Hover on the folder that you wish to move inside another folder.
  2. On the extreme right side, you will notice three vertical dots which is the 'More Options' icon. Click on this icon and select 'Move to' to move it to another folder.
  3. Move to folder.png

  4. Select the folder where you want to move your current folder and click on 'Move here'.

This will move your folder within the selected folder. You can add multiple folders within any folder.

Delete a Folder

You can delete a folder by performing the steps given below:

  1. Hover on the folder that you wish to delete.
  2. On the extreme right side, you will notice three vertical dots which is the 'More Options' icon. Click on this icon and select 'Delete' to delete this folder.
  3. Delete folder.png

  4. Confirm your action by clicking on 'Delete'.

This will delete your folder along with the asset files within it.

arrow-up