---
title: "Contentstack limits on one page"
url: "https://developers.contentstack.com/guides/contentstack-limits-on-one-page"
type: "guide"
level: "beginner"
intent: "learn"
outcome: "You know the public Contentstack limits that affect your content model, your queries and your jobs, which of them depend on your plan, and what happens when you hit one."
prerequisites:
  - "A Contentstack organization and stack, or one you are planning"
  - "Basic knowledge of content types, entries and the Delivery API"
tags:
  - "api"
  - "headless"
  - "content_modeling"
authors:
  - "Tim Benniks"
published: "2026-12-02T09:00:00.000Z"
updated: "2026-11-15T10:55:45.531Z"
---

# Contentstack limits on one page

- **Authors:** Tim Benniks
- **Published:** 2026-12-02T09:00:00.000Z
- **Updated:** 2026-11-15T10:55:45.531Z
- **Level:** Beginner
- **Intent:** Learn
- **Tags:** api, headless, content_modeling

---

Contentstack limits are spread over dozens of documentation pages, and you usually find the right one after you hit the limit. This page collects the public limits in one place, grouped by area, so you can check a content model or a job before it fails.

Every value here comes from the public documentation and was checked in December 2026. Limits change, and many depend on your plan, so follow the docs link in each section for the current value.

## What you'll learn

- The API rate limits and why they are per organization


- How deep you can include references in REST and GraphQL


- The schema limits for content types, fields, Modular Blocks and Global fields


- The limits for taxonomy, entry variants, assets, publishing, webhooks, Launch and the CLI


- Which limits depend on your plan, and which guide helps when you hit one



## How to read this page

Plan-dependent means the documentation says the value depends on your plan, or that Contentstack support can raise it. Default values apply when nothing else is set for your organization. Where two documentation pages disagree, the table gives the value from the most recently updated page and says so.

Two things to keep in mind before the tables:

- Rate limits are per organization. Your builds, imports, scripts, Automate workflows and integrations all share them.


- Cached Delivery API responses are not rate limited. Only requests that reach the origin count. They all still count toward your overall API usage.



## API rate limits

Limit

Value

Plan-dependent

When you hit it

Docs

Content Delivery API, uncached requests

100 per second per organization

Yes

HTTP 429

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Image Delivery API, uncached requests

Counts toward the CDA limit

Yes

HTTP 429

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

GraphQL Content Delivery API, uncached requests

80 per second per organization

Yes

HTTP 429

[GraphQL](https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api)

Content Management API, reads

10 per second per organization

Yes

HTTP 429

[CMA](https://www.contentstack.com/docs/developers/apis/content-management-api)

Content Management API, writes

10 per second per organization

Yes

HTTP 429

[CMA](https://www.contentstack.com/docs/developers/apis/content-management-api)

CMA bulk actions

1 request per second

Yes

HTTP 429

[CMA](https://www.contentstack.com/docs/developers/apis/content-management-api)

Stack creation

1 stack per minute per organization

No

Request rejected

[Stack limitations](https://www.contentstack.com/docs/headless-cms/stack-limitations)

The X-RateLimit-Limit and X-RateLimit-Remaining response headers show your actual limit and what's left in the current second. When you hit a rate limit, read [Fix 429 rate limit errors in builds, imports and bulk publish](/guides/fix-429-rate-limit-errors-in-builds-imports-and-bulk-publish). For timeouts and 5xx errors, read [ETIMEDOUT, 5xx and timeouts from the Delivery API](/guides/etimedout-5xx-and-timeouts-from-the-delivery-api).

## Content Delivery API (REST)

Limit

Value

Plan-dependent

When you hit it

Docs

Request URL size on the CDN

8 KB

No

HTTP 414 URI Too Long

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Entries or assets per response

100 by default; set more with limit and page with skip

No

You get the first page only

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Content types per "get all content types" response

100

No

Page with skip

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

include_all_depth

5 levels (include_all alone resolves 1)

No

Error

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Reference paths per request (include[] or include_all)

100

No

Error; reduce depth or includes

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Depth of a multiple content type Reference field

3 levels

No

Not documented

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Recursive embedded items (embedded_items_depth)

5 levels

No

Values above 5 are clamped to 5

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Sync API page size

100 items

No

You get a pagination_token for the next page

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Long $in lists and many includes push a URL past 8 KB. [Nested references empty or error 141](/guides/nested-references-empty-or-error-141) covers both.

## GraphQL Content Delivery API

Limit

Value

Plan-dependent

When you hit it

Docs

Nested reference depth

3 levels

No

Query rejected

[GraphQL limitations](https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api/limitations)

Reference depth in a where filter

3 levels

No

Query rejected

[GraphQL limitations](https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api/limitations)

Objects fetched in one query

7,500

No

Query rejected

[GraphQL limitations](https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api/limitations)

Referenced items per Reference field

100

No

Page with skip and limit on the connection

[GraphQL limitations](https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api/limitations)

Embedded items per JSON RTE field

100

No

Page the embedded items

[GraphQL limitations](https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api/limitations)

Content types queried in one request

3

No

Query rejected

[GraphQL limitations](https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api/limitations)

Response size

7 MB

No

Query rejected

[GraphQL limitations](https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api/limitations)

limit on a collection

25 by default, 100 maximum

No

Page with skip

[GraphQL](https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api)

Content type schemas generated per request

100

No

Page the introspection schema

[GraphQL limitations](https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api/limitations)

GraphQL errors don't always come back as a non-200 status. [GraphQL errors decoded](/guides/graphql-errors-decoded) lists the error codes and what each one means.

## Content types, fields and Global fields

Limit

Value

Plan-dependent

When you hit it

Docs

Fields per content type, including nested fields

400

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Content type UID

200 characters; letters, numbers and underscores

No

Schema save rejected

[Content type limitations](https://www.contentstack.com/docs/developers/create-content-types/limitations-of-content-types)

Content type description

255 characters

No

Schema save rejected

[Content type limitations](https://www.contentstack.com/docs/developers/create-content-types/limitations-of-content-types)

Title field and Display Name

200 characters

Default

Save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Modular Blocks fields per content type

5

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Block definitions per Modular Blocks field

100

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Block instances per Modular Blocks field in an entry

100

Default

Entry save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Nested block levels

2

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Group nesting

5 levels

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Fields in a Group, including nested fields

100

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Global fields per content type

25

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Global fields per organization

1,000

Default

Creation rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Fields within a Global field

100

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Global field nesting

5 levels, including the parent

Default

Schema save rejected

[Global field limitations](https://www.contentstack.com/docs/developers/global-field/limitations-of-global-field)

Instances of a Global field marked Multiple

100

No

Entry save rejected

[Global field limitations](https://www.contentstack.com/docs/developers/global-field/limitations-of-global-field)

Custom fields per content type

10

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Select field options

100, each up to 100 characters

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Field visibility rules per content type

10 rules, 5 conditions and 5 target fields each

Default

Schema save rejected

[Field limitations](https://www.contentstack.com/docs/headless-cms/field-limitations)

Reference field query limit

100

No

Not documented

[Entries limitations](https://www.contentstack.com/docs/headless-cms/entries-limitations)

Tags per entry

50, each up to 50 characters

No

Entry save rejected

[Entries limitations](https://www.contentstack.com/docs/headless-cms/entries-limitations)

> Watch for: The Field Limitations page (updated November 2026) gives 400 fields per content type and 100 fields within a Global field. The older content type and Global field pages say 500 for both. Plan against the lower number.

Fields inside Modular Blocks, Groups and Global fields all count toward the content type total. [Modular Blocks, references or Global fields](/guides/modular-blocks-references-or-global-fields) helps you pick the structure that keeps the count down.

## Taxonomy

Limit

Value

Plan-dependent

When you hit it

Docs

Taxonomies per stack

Depends on your plan

Yes

Creation rejected

[Taxonomy limitations](https://www.contentstack.com/docs/headless-cms/limitations-for-taxonomy)

Terms per taxonomy

10,000

No

Term creation rejected

[Taxonomy limitations](https://www.contentstack.com/docs/headless-cms/limitations-for-taxonomy)

Terms per entry

25

No

Entry save rejected

[Taxonomy limitations](https://www.contentstack.com/docs/headless-cms/limitations-for-taxonomy)

Term depth

10 levels

No

Term creation rejected

[Taxonomy limitations](https://www.contentstack.com/docs/headless-cms/limitations-for-taxonomy)

Taxonomy and term name or UID

50 characters

No

Save rejected

[Taxonomy limitations](https://www.contentstack.com/docs/headless-cms/limitations-for-taxonomy)

Taxonomy fields per content type

1, which can hold several taxonomies

No

Not possible to add a second

[Taxonomy limitations](https://www.contentstack.com/docs/headless-cms/limitations-for-taxonomy)

The Taxonomy field can't go inside Modular Blocks or Groups, and only published taxonomies are available through the Delivery API. [Querying content by taxonomy](/guides/querying-content-by-taxonomy) shows how the limits shape queries.

## Entry variants

Limit

Value

Plan-dependent

When you hit it

Docs

Variants merged with the base entry per CDN request

3

No

Only 3 variants are merged

[Entry variant limitations](https://www.contentstack.com/docs/headless-cms/limitations-for-entry-variants)

Timeout for entry variant requests

10 seconds

No

Request fails

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Response size, all variants of an entry

10 MB

No

Request fails

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Response size, a single entry variant

3 MB

No

Request fails

[CDA](https://www.contentstack.com/docs/developers/apis/content-delivery-api)

Entry variants need to be enabled for your organization, and custom queries only match base entry data. [Personalize variant returns base entry or null](/guides/personalize-variant-returns-base-entry-or-null) covers the most common problems.

## Stacks, branches, environments and locales

Limit

Value

Plan-dependent

When you hit it

Docs

Branches per stack

5

Yes

Creation rejected

[Stack limitations](https://www.contentstack.com/docs/headless-cms/stack-limitations)

Branch ID

15 characters, lowercase, _ as separator

No

Creation rejected

[Branch limitations](https://www.contentstack.com/docs/headless-cms/limitations-of-branches)

Environments per stack

5

Default

Creation rejected

[Stack limitations](https://www.contentstack.com/docs/headless-cms/stack-limitations)

Fallback language levels

1

No

You can't chain fallbacks

[Localization limitations](https://www.contentstack.com/docs/headless-cms/limitations-of-localization)

Management tokens per stack

10 valid at a time

No

Creation rejected

[CMA](https://www.contentstack.com/docs/developers/apis/content-management-api)

Authtokens per user

20 valid at a time

No

Not documented

[CMA](https://www.contentstack.com/docs/developers/apis/content-management-api)

The one-level fallback rule explains most "why am I getting en-us content" questions. [Locale fallback explained](/guides/why-am-i-getting-en-us-content-locale-fallback-explained) walks through it.

## Assets and images

Limit

Value

Plan-dependent

When you hit it

Docs

Asset file size

700 MB in the UI, 100 MB through the API

Can be raised

Upload rejected

[Asset limitations](https://www.contentstack.com/docs/headless-cms/asset-limitations)

Assets per upload batch

10

Can be raised

Upload rejected

[Asset limitations](https://www.contentstack.com/docs/headless-cms/asset-limitations)

Assets per stack

10,000

Can be raised

Upload rejected

[Asset limitations](https://www.contentstack.com/docs/headless-cms/asset-limitations)

Image optimization input size

50 MB

Can be raised

Not documented

[Asset limitations](https://www.contentstack.com/docs/headless-cms/asset-limitations)

Image optimization input dimensions

12,000 × 12,000 pixels

Can be raised

Not documented

[Asset limitations](https://www.contentstack.com/docs/headless-cms/asset-limitations)

Image optimization output dimensions

8,192 × 8,192 pixels

Can be raised

Not documented

[Asset limitations](https://www.contentstack.com/docs/headless-cms/asset-limitations)

Animated GIF frames

1,000

Can be raised

Not documented

[Asset limitations](https://www.contentstack.com/docs/headless-cms/asset-limitations)

These apply to assets stored in a stack. The newer Assets product raises several of them. [Image transforms that surprise you](/guides/image-transforms-that-surprise-you) covers transform behavior.

## Publishing, bulk operations and releases

Limit

Value

Plan-dependent

When you hit it

Docs

Bulk publish or unpublish in the UI

100 entries, 10 languages, 10 environments at a time

Can be raised

Selection capped

[Bulk operation limitations](https://www.contentstack.com/docs/headless-cms/limitations-of-bulk-operations-on-entries)

Items per bulk publish API request

10

Plan feature

Split into more requests

[CMA bulk operations](https://www.contentstack.com/docs/developers/apis/content-management-api/bulk-operations)

Select all records

10,000 entries

No

Only the first 10,000 are acted on

[Bulk operation limitations](https://www.contentstack.com/docs/headless-cms/limitations-of-bulk-operations-on-entries)

Bulk delete in the UI

100 entries

Can be raised

Selection capped

[Bulk operation limitations](https://www.contentstack.com/docs/headless-cms/limitations-of-bulk-operations-on-entries)

Scheduled bulk action

Up to 12 months ahead

No

Date rejected

[Bulk operation limitations](https://www.contentstack.com/docs/headless-cms/limitations-of-bulk-operations-on-entries)

Nested reference publishing depth

5 levels

Yes

Deeper references aren't published

[Nested reference publishing](https://www.contentstack.com/docs/headless-cms/limitations-for-nested-reference-publishing)

Parent entries in a nested bulk publish

100

No

Selection capped

[Nested reference publishing](https://www.contentstack.com/docs/headless-cms/limitations-for-nested-reference-publishing)

Active bulk publish jobs per organization

2

No

Extra jobs wait

[Nested reference publishing](https://www.contentstack.com/docs/headless-cms/limitations-for-nested-reference-publishing)

Items in a release

500

No

Item not added

[Release limitations](https://www.contentstack.com/docs/headless-cms/releases-limitations)

Items added to a release per API request

25

No

Split into more requests

[Release limitations](https://www.contentstack.com/docs/headless-cms/releases-limitations)

Nested reference publishing doesn't apply when you publish through a release. [Releases, bulk publish and nested reference publishing explained](/blog/releases-bulk-publish-and-nested-reference-publishing-explained) compares the options, and [Publishing stuck or references not published](/guides/publishing-stuck-or-references-not-published) helps when a job doesn't finish.

## Webhooks

Limit

Value

Plan-dependent

When you hit it

Docs

Webhooks per stack

100

Can be raised

Creation rejected

[Webhook limitations](https://www.contentstack.com/docs/headless-cms/limitations-of-webhooks)

Conditions per webhook

200

No

Save rejected

[Webhook limitations](https://www.contentstack.com/docs/headless-cms/limitations-of-webhooks)

Emails notified when the circuit breaker disables a webhook

10

No

Save rejected

[Webhook limitations](https://www.contentstack.com/docs/headless-cms/limitations-of-webhooks)

[Webhooks: allowlisting, signatures and disabled endpoints](/guides/webhooks-allowlisting-signatures-and-disabled-endpoints) covers the circuit breaker and how to get a disabled webhook running again.

## Launch

Limit

Value

Plan-dependent

When you hit it

Docs

Request headers

About 10 KB

No

Request rejected

[Launch platform limits](https://www.contentstack.com/docs/launch/platform-limits-on-launch)

Request body

128 KB on the platform limits page; the CF1001 error reference says 5 MB

No

Request rejected with 413 (CF1001)

[Launch platform limits](https://www.contentstack.com/docs/launch/platform-limits-on-launch)

Response headers

32 KB

No

Response fails

[Launch platform limits](https://www.contentstack.com/docs/launch/platform-limits-on-launch)

Response body

5 MB

No

Response fails

[Launch platform limits](https://www.contentstack.com/docs/launch/platform-limits-on-launch)

Cloud Function and SSR request timeout

30 seconds by default, up to 780 seconds

Yes

Request times out

[Launch platform limits](https://www.contentstack.com/docs/launch/platform-limits-on-launch)

Time to first response byte

98 seconds

No

Connection closes

[Launch platform limits](https://www.contentstack.com/docs/launch/platform-limits-on-launch)

Cache revalidations per day

500 (Enterprise: 2,000)

Yes

Revalidation rejected until 00:00 UTC

[Launch platform limits](https://www.contentstack.com/docs/launch/platform-limits-on-launch)

Origin delivery rate

200 requests per second (Enterprise: 1,200)

Yes

Origin requests throttled

[Launch platform limits](https://www.contentstack.com/docs/launch/platform-limits-on-launch)

The origin delivery limit counts cache misses to your site's origin, separate from the API rate limits your code calls. Edge function limits, environment variable limits and log retention are in [Logs, debugging and limits](/guides/launch-edge-functions-redirects-and-caching/logs-debugging-and-limits). The error codes you see when a Launch limit is hit are in [Launch error codes decoded](/guides/launch-error-codes-decoded).

## CLI

Limit

Value

Plan-dependent

When you hit it

Docs

Request and response size (maxContentLength, maxBodyLength)

100 MB by default

Configurable in the config file

Export or import fails

[CLI import](https://www.contentstack.com/docs/headless-cms/import-content-using-the-cli)

Share of the rate limit the CLI uses

50% by default

Configurable with csdx config:set:rate-limit

Slower jobs, fewer 429s

[CLI rate limits](https://www.contentstack.com/docs/headless-cms/configure-rate-limits-in-the-cli)

[csdx import and export failures](/guides/csdx-import-and-export-failures) covers memory errors and other ways large CLI jobs fail.

## Key takeaways

- API rate limits are per organization: 100 uncached CDA requests per second, 80 for GraphQL, 10 reads and 10 writes for the CMA, 1 per second for bulk actions. Your plan can change all of them.


- Cached Delivery API responses don't count against the rate limit, so caching is the cheapest way to stay under it.


- REST includes go 5 levels deep with at most 100 reference paths. GraphQL goes 3 levels deep and returns at most 7 MB.


- A content type holds 400 fields in total, counting everything inside Modular Blocks, Groups and Global fields.


- Taxonomies allow 25 terms per entry and 10 levels of depth. Releases hold 500 items.


- On Launch, server functions time out after 30 seconds by default, and responses are capped at 5 MB.


- Values were checked in December 2026. Follow the docs link in each section for the current number.





---

## Do this with AI

Install the cms-data-modeling-best-practices skill from [Contentstack agent skills](https://github.com/contentstack/contentstack-agent-skills) and connect the Content Modeler profile in MCP Profile Hub. Then ask your agent:

> Go through every content type in my stack and report which ones are close to a limit: more than 300 fields in total, more than 20 Global fields, Modular Blocks nested 2 levels deep, or more than 80 block definitions in one Modular Blocks field. Suggest how to simplify the worst three, but don't change any schema.

New to this? [Set up your AI workbench](/guides/set-up-your-ai-workbench-for-contentstack) first.




---

## Frequently asked questions

### Are Contentstack rate limits per stack or per organization?

Per organization. Every stack, build, script and integration in the organization shares the same API rate limits.

### Can Contentstack limits be raised?

Many can. Rate limits, nested reference publishing depth, the number of taxonomies and branches, and several asset and webhook limits depend on your plan or can be raised by Contentstack support.

### How many fields can a content type have?

The Field Limitations page lists a maximum of 400 fields per content type, counting fields inside Modular Blocks, groups and Global fields.

### How deep can I include references in one Delivery API request?

Up to 5 levels with include_all_depth on the REST Delivery API, and up to 100 reference paths per request. GraphQL fetches nested references up to 3 levels deep.

### When were these values checked?

In December 2026, against the public Contentstack documentation. Each section links to the page it comes from, so check there for the current value.

