Assets | Documentation | Contentful Docs

Assets are the binary files in a space. An asset can be any file type and are usually attached to entries with links.

You can localize assets by providing separate files for each locale. Assets which are not localized are available as a single file under the default locale.

When you query for entries which contain links to assets then all assets are included by default.

Asset properties:

Field	Type	Description
sys	Sys	Common system properties.
metadata	Metadata	User-controlled metadata. NOTE: Currently holds `tags` and `concepts` property, which contains lists of tags and taxonomy concepts assigned to an asset, respectively.
fields.title	Text	Title of the asset.
fields.description	Text	Description of the asset.
fields.file	File	File(s) of the asset.
fields.file.fileName	Symbol	Original filename of the file.
fields.file.contentType	Symbol	Content type of the file.
fields.file.url	Symbol	URL of the file.
fields.file.details	Object	Details of the file, depending on its MIME type.
fields.file.details.size	Number	Size (in bytes) of the file.

For image assets, the fields.file.url field will point to images.ctfassets.net. For other file types, it will point to assets.ctfassets.net.

For large image assets (greater than 100MB and other asset files greater than 10MB) use the downloads.ctfassets.net.

You can use query parameters to define the image size, cropping parameters and other options. Find out more in our Images API reference.

For video assets, use videos.ctfassets.net.

Assets collection

Get all assets of a space

Asset

Get an asset