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

An installation copies items from a design library version into a target environment.

> **Info**
>
> Installation is asynchronous:
>
> * A `201` response creates the installation and queues processing.
> * Poll [Get a design library installation](/developers/docs/references/experience-management-api/design-libraries/installations/get-design-library-installation) until `sys.status` is `succeeded` or `failed`.

> **Warning**
>
> You cannot install a design library into its source space.

## Concurrent installation limit

A target organisation can have up to **100 concurrent design library installations** across all its spaces, environments and libraries. Installations with `sys.status` set to `created` or `in_progress` count towards this limit. Installations with status `succeeded` or `failed` do not count.

When the limit is reached, creating another installation returns `409 Conflict` with the message `Parallel installation limit reached` and `details.limit` set to `100`. No installation is created or queued. Retry after an active installation finishes and capacity becomes available.

## Installations

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

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

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