Working with media files (assets)

You can add or update files from the Media tab in the Contentful web app. In Contentful, we refer to these media files as assets.

All of the assets you upload to Contentful live in the Media tab.

You can add filters to search through your media assets just as you can with entries. See our search and filter article for more information.

Adding new assets

To add a new asset, follow these steps:

  1. In the web app, click the Media tab in the top navigation bar.

  2. From the Media tab, click the Add asset button.

  3. Select whether you want to upload a single asset or multiple assets.

You can either drag and drop your media file into the window or select it from your computer. 

Adding multiple assets at once

To add multiple assets at once: 

  1. In the web app, click the Media tab in the top navigation bar. 

  2. Click Add asset button.

  3. Select Multiple assets.

  4. After you have selected your files, click Upload.

If you choose to upload multiple assets, then you have the option to choose to upload from external sources, such as Google Images, Instagram, Facebook, Dropbox, Google Drive, OneDrive and more. 

  • You can add a maximum of 20 files at once.

  • Maximum file size: 1000MB (1GB) per uploaded file. See our Fair Usage Policy for more information. 

Note: At the moment, if you encounter an error during the upload process, the web app does not allow you to resume the upload. If an error occurs, you will need to restart the upload process from the beginning. 

Publish an asset

  1. In the web app, click the Media tab.

  2. Select an asset from the list.

  3. Click Publish.

Archive an asset

  1. In the web app, click the Media tab.

  2. Select the asset you want to archive.

  3. If the asset's current status is Draft or Changed, click the arrow on the right of the Publish button and select Archive.

  4. If the asset's status is Published, then click the button Change status and select Archive.

Download an asset

  1. In the web app, click the Media tab.

  2. Select the asset you want to download.

  3. In the media file editor, hover the section File (required).

  4. From the set of icons the show up, click the button with the arrow pointing down icon, labeled Download file.

Delete an asset

  1. In the web app, click the Media tab.

  2. Click the asset you want to delete.

  3. Click Delete from the top right area.

Mass actions for assets

To perform mass actions on media assets:

  1. In web app, click the Media tab

  2. From the list, select the assets you want to act on.

  3. Click one of the available actions on the top of the list. 

Depending on the status of the assets you selected, you have the option to publish, unpublish, delete, duplicate, archive or unarchive.

Naming and describing assets

After uploading assets to Contentful, we recommend you add a title and description. This makes it easier to organize your media list, and to search and filter for specific assets later.

For titles, we recommend using your company's file naming convention.

Titles and descriptions are not required, but can be useful for SEO purposes, or image descriptions shown for users with disabilities.

Editing image assets

You can perform some basic image editing directly in the web app, such as rotate, resize and crop. 


The media file editor in Contentful

Working with multiple resolutions of an image

With Contentful, there’s no need to upload multiple image versions at different resolutions. Having just one image at the highest resolution you need is enough. The rest can be done by developers using our Images API, which allows for an image to be transformed on the fly, in terms of resizing, cropping or changing the resolution. Have your developer team read our Images API developer docs for more information.

Working with metadata

By default, the files added in the Media page have only a title and a description. If you need to add more information, we recommend creating a dedicated content type for your media files. 

With a dedicated content type, you will have different fields available for any other properties you need. You can add fields for SEO, tags or alt text, and create something that fits your needs.

When creating dedicated content types for your media files, keep in mind that you will need to link them using a “Reference” field, not an image field. This also means that those media files will be located in the Conten tab and not the Media tab. The media file will always be added to the Media tab, but the entry with the file and its extended metadata will be located in the Content tab.

Working with a Digital Asset Management (DAM) service

If you use a specific digital asset management service, you can create an app to integrate it with the Contentful web app. 

We offer integrations with CloudinaryBynderDropbox and Frontify. These apps can only be installed by space admins. 

In the case you work with other services, you will need to develop your own app. That can be done faster using one of the existing apps as an example.