> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/developers/docs/_mcp/server.

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](/references/content-preview-api/tags) and [taxonomy concepts](/references/content-delivery-api/overview) 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](/references/images-api/overview) reference.

For video assets, use `videos.ctfassets.net`.

## Assets collection

[Get all assets of a space](/references/content-preview-api/assets/get-all-assets)

## Asset

[Get an asset](/references/content-preview-api/assets/get-an-asset)