> This page is for API Reference.

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

A design library is a collection of reusable experience templates, components, design tokens, content types, data assemblies (binding configurations) and editor interfaces that can be shared across spaces and environments.

> **Info**
>
> This feature is currently available only on specific plans. For more information, reach out to your [Sales representative](https://www.contentful.com/contact/sales/).

## How items are included

When creating a design library, supply a source environment and a taxonomy concept ID in `basedOn`. The concept identifies which items to include when creating a version.

### Items selected by taxonomy

The version includes components, design tokens and experience templates assigned that concept in the source environment.

### Associated items

The version also includes:

* Data assemblies used by those components and experience templates, including data assemblies used within other data assemblies.
* Content types used by those data assemblies, together with their editor interfaces, when `includeLinkedContentTypes` is set to `true`.

These associated items do not need the taxonomy concept assigned to them.

Creating a design library saves these selection settings. Items are copied when you create a version.

## Design library

[List design libraries](/developers/docs/references/experience-management-api/design-libraries/list-design-libraries)

[Create a design library](/developers/docs/references/experience-management-api/design-libraries/create-design-library)

[Get a design library](/developers/docs/references/experience-management-api/design-libraries/get-design-library)

[Update a design library](/developers/docs/references/experience-management-api/design-libraries/update-design-library)

[Delete a design library](/developers/docs/references/experience-management-api/design-libraries/delete-design-library)

## Versions

A version is an immutable snapshot of a design library's items.

[Versions](/developers/docs/references/experience-management-api/design-libraries/versions)

## Installations

An installation tracks the application of a design library version to a target environment.

[Installations](/developers/docs/references/experience-management-api/design-libraries/installations)

## Limits

| Limit                          | Maximum                                                                    |
| ------------------------------ | -------------------------------------------------------------------------- |
| Items per version              | 1,000 unique fetched items across all item types.                          |
| Library or version name        | 256 characters.                                                            |
| Library or version description | 1,000 characters.                                                          |
| Versions being created         | One per library with status `created` or `in_progress`.                    |
| Concurrent installations       | 100 per target organisation across all spaces, environments and libraries. |
| Results per list page          | 100 items.                                                                 |

The version item limit includes derived content types and data assemblies.

The concurrent installation limit counts installations with status `created` or `in_progress`. Capacity becomes available when an installation succeeds or fails. See [Concurrent installation limit](/developers/docs/references/experience-management-api/design-libraries/installations#concurrent-installation-limit) for how to handle capacity errors.

## Pagination

List operations use [cursor pagination](/developers/docs/references/content-management-api/overview#cursor-pagination).