On this page we've included the various limits for the Dynamic Content APIs and general usage of the Dynamic Content app. Limits for Content Hub and apps are also included.

Note that most of these limits are hard coded and cannot be changed. Generally you should not be close to these limits.

Content delivery 2

Feature limit Description
Delivery Keys 150 characters maximum. Must conform to validation rules and be unique on a hub
Get multiple content items 12 items in the request The combined maximum of either delivery keys or ids
Nested content 22 levels The content graph of a content item may be nested up to a depth of 22 levels.
If you are close to this limit, you may consider using content references instead of content links.
Content item body size 200 KB The maximum size of the content item body.
Request time limit 10 seconds The maximum time allowed before a request times out.

Filter API

The following limits apply to the trait:filterable and trait:sortable sections of content type schemas.


Feature limit Description
filterBy paths 5 Up to 5 filterBy paths can be included in a filterable trait
Entries in filterBy paths 5 Up to 5 entries can be included in a filterBy path
filterBy path entry 128 characters The maximum length of an entry in a filterBy path


Feature limit Description
sortBy paths 3 Up to 3 sortBy paths can be included in a sortable trait
Entries in sortBy paths 5 Up to 5 entries can be included in a sortBy path
sortBy key 128 characters The maximum length of a sort key

Other limits

Feature limit Description
Page size 12 The maximum number of items that can be returned in one page of a response
Complexity limit 500 items This refers to the number of content items involved in processing a request. If the limit is exceeded, a 524 error is returned


Feature limit Description
Hierarchy tree depth 15 The number of levels that can be added to a hierarchy
Hierarchy item limit 10,000 The total number of items that can be added to a hierarchy
Node children limit 500 The number of children that can be added to a node

Fresh API

The Fresh API uses the same format of requests and responses, and is subject to the same limits, as the Content Delivery 2 API and Filter API. There are also some additional rate limits:

Feature limit Description
API requests 100 requests per second.
Burst limit: 200 requests per second
This rate limit applies to requests to the Fresh API

Requests to the Fresh API are tracked against the API keys assigned to your hubs. Each of these API keys has a rate limit associated with it. Exceeding the rate limit will result in 429 responses from the service. When receiving a 429, your code should attempt a retry after delaying the next request with exponential back-off.


Snapshots are an immutable representation of a content item. Snapshots are generated when:

  • A content item snapshot is saved to an edition or content is added to a slot in an edition
  • Content is published
  • Editions are scheduled
  • Editions are previewed
Feature limit Description
Snapshot 2500 items The maximum number of items in a snapshot

Content rendering service

Feature limit Description
Response size The maximum response size is 64 MB This is the size of the HTML response
Maximum number of handlebars templates 50 The maximum number of distinct handlebars templates that can be invoked as a result of a single request is 50
Maximum number of partials 1000 The maximum number of partials that can be loaded as a result of single request

Content type schemas

Feature limit Description
Schema URL size 950 The maximum size of a content type schema URL is 950 characters


Feature limit Description
Custom payload The maximum size of the custom payload is 5 KB This is the handlebars template that defines the custom payload
Webhook request The maximum size of the custom payload output is 200 KB This is the output size when the custom payload is processed.
Webhook request headers 7 KB This is maximum size of all headers combined
Webhook request retry attempts 18 The maximum number of retry attempts for HTTP requests. The maximum duration for retries is 12 hours
Custom payload retry attempts 5 The maximum number of retry attempts when creating a custom payload. The maximum duration for retries is 15 minutes
Feature limit Description
Search index record size 100 KB The maximum size of a record stored in a search index is 100 KB
Search analytics data 90 days The length of time search analytics data is stored

API Rate limits

In addition to the rate limits shown below, Amplience reserves the right to impose rate limits on requests to the Dynamic Content Management API. We will only do this to help guarantee service availability to all our customers.

Feature limit Description
Publish content requests 100 request per minute This rate limit applies to Dynamic Content Management API requests that publish content

Dynamic Content usage

Feature limit Description
Content item statuses 100 This is the maximum number of content item statuses that can be added to a hub
Edition slots 200 Up to 200 slots can be added to an edition
Content versions 2300 The maximum number of versions for a content item

Content hub and apps

Feature limit Description
Asset manual upload 100 MB The maximum size files that can be uploaded with a manual upload
Media share assets 800 Maximum number of assets in a single share
Media share size limit 1000 MB The maximum size of a single share