Technical Limits (legacy September 2022)

We enforce technical limits to ensure the shared-service infrastructure functions without interruption. Only use Contentful software and services if you agree with the technical limits outlined below. These limits apply solely to current plans. Plans introduced before September 1, 2022 are subject to the legacy technical limits (Technical Limits legacy August 2022).

For an in-depth explanation of each plan, see our pricing page.

Jump to: Community plan | Team plan | Premium plan

Community plan

Organizations on the Community plan are subject to the following technical limits:

MetricPlan limitUnit of measure
Bulk Actions200Max of items per bulk action
Bulk Actions5Max active bulk actions. Number per space
Content Delivery API (CDA) calls (includes GraphQL calls)55Calls per second. Number per space
Content Management API (CMA) calls7Calls per second. Number per space
Content Preview API (CPA) calls14Calls per second. Number per space
Content types48Number per environment
Content type fields50Number of fields per content type
Environments3Number per space
Environment creation12Number per 5 minutes
Environment alias1Number per space
Users5Number per organization
Roles2Number per space
Spaces1Total number
Records25000Number per environment
API keys100Number per organization
Webhooks20Number per space
Locales2Number per environment
Request size1MB
GraphQL request size8KB
Response size7MB
URI request length7600characters
Image size20MB per image
Image size (pixels), for animated GIFs total pixels = width x height x number of frames300Megapixels
Image size (megapixels), for source images transformed into AVIF format9Megapixels
Asset or image filename length256Characters with extension
Asset size, including images larger than the image size limit50MB per asset
Entry size2MB
Long text field50000Characters per field
Short text field256Characters per field
Short text, list field1000Items per field
Rich Text field200000Characters per field (field size cannot exceed a payload of 1MB)
References, many field1000Linked entries per field
References, entry descendants10Levels deep
Scheduled actions500Number per space
Release200Number of entities or assets
Release actions2Number of release actions, per minute
Scheduled actions, scheduled time200Number of scheduled actions to be executed at, per minute
Scheduled release actions, scheduled time2Number of scheduled actions for releases, per minute
Scheduled action, maximum datetime60Months from time of creation
App Definitions10Number per organization
App Installations10Number per environment
Tags500Number per environment
Tags100Number per asset or entry

Technical limits are cumulative and can be reset only when an organization’s users delete individual items.

If you require higher limits, consider upgrading to the Team or Premium plan, which come with higher default limits. The Premium plan also features the ability to purchase custom usage-quotas for your organization.

If your service usage exceeds the preceding limits, we reserve the right to take corrective action, including but not limited to the throttling of the service API, temporarily suspending or (when other options are unavailable) terminating your account.

Team plan

Organizations on the Team plan are subject to the following technical limits:

MetricPlan limitUnit of measure
Bulk Actions200Max of items per bulk action
Bulk Actions5Max active bulk actions. Number per space
Content Delivery API (CDA) calls (includes GraphQL calls)78Calls per second. Number per space
Content Management API (CMA) calls10Calls per second. Number per space
Content Preview API (CPA) calls20Calls per second. Number per space
Content types48Number per environment
Content type fields50Number of fields per content type
Environments5Number per space
Environment creation12Number per 5 minutes
Environment alias1Number per space
Users **10Number per organization
Roles4Number per space
Spaces20Total number
Records50000Number per environment
API keys100Number per organization
Webhooks20Number per space
Locales10Number per environment
Request size1MB
GraphQL request size8KB
Response size7MB
URI request length7600characters
Image size20MB per image
Image size (pixels), for animated GIFs total pixels = width x height x number of frames300Megapixels
Image size (megapixels), for source images transformed into AVIF format9Megapixels
Asset or image filename length256Characters with extension
Asset size, including images larger than the image size limit1000MB per asset
Entry size2MB
Long text field50000Characters per field
Short text field256Characters per field
Short text, list field1,000Items per field
Rich Text field200,000Characters per field (field size cannot exceed a payload of 1MB)
Entry links (reference, media and Rich Text fields)1,000Total number of links across all of the fields of an entry
Scheduled actions500Number per space
Release actions2Number of release actions, per minute
Release200Number of entities or assets
Scheduled actions, scheduled time200Number of scheduled actions to be executed at, per minute
Scheduled release actions, scheduled time2Number of scheduled actions for releases, per minute
Scheduled action, maximum datetime60Months from time of creation
App Definitions250Number per organization
App Installations50Number per environment
Tags500Number per environment
Tags100Number per asset or entry

Technical limits are cumulative and can be reset only when an organization’s users delete individual items.

** 10 users are free. Customers on the Team plan can purchase an additional 15 users for $15/mo/user.

If you require higher limits, consider upgrading to the Premium plan, which comes with higher default limits and the ability to purchase custom usage-quotas for your organization.

If your service usage exceeds the preceding limits, we reserve the right to take corrective action, including but not limited to the throttling of the service API, temporarily suspending or (when other options are unavailable) terminating your account.

Premium plan

Organizations hosted on our Premium plan are subject to the following technical limits:

MetricPlan limit †Unit of measure
Bulk Actions200Max of items per bulk action
Bulk Actions5Max active bulk actions. Number per space
Content Delivery API (CDA) calls (includes GraphQL calls)78Calls per second. Number per space
Content Management API (CMA) calls10Calls per second. Number per space
Content Preview API (CPA) calls20Calls per second. Number per space
Content typescustomNumber per environment
Content type fields50Number of fields per content type
EnvironmentscustomNumber per space
Environment creation12Number per 5 minutes
Environment alias3 (master + 2 custom)Number per space
Users **customNumber per organization
RolescustomNumber per organization
SpacescustomNumber per organization
RecordscustomNumber per environment
API keys200Number per organization
Webhooks100Number per space
LocalescustomNumber per organization
Request size1MB
GraphQL request size8KB
Response size7MB
Custom rolesyes
Image size20MB per image
Image size (pixels), for animated GIFs total pixels = width x height x number of frames300Megapixels
Image size (megapixels), for source images transformed into AVIF format9Megapixels
Asset or image filename length256Characters with extension
Asset size, including images larger than the image size limit1,000MB per asset
Entry size2MB
Long text field50000Characters per field
Short text field256Characters per field
Short text, list field1,000Items per field
Rich Text field200,000Characters per field (field size cannot exceed a payload of 1MB)
Entry links (reference, media and Rich Text fields)1,000Total number of links across all of the fields of an entry
Scheduled actions500Number per space
Release200Number of entities or assets
Release actions2Number of release actions, per minute
Scheduled actions, scheduled time200Number of scheduled actions to be executed at, per minute
Scheduled release actions, scheduled time2Number of scheduled actions for releases, per minute
Scheduled action, maximum datetime60Months from time of creation
Records5,000,000Number per space
App Definitions250Number per organization
App Installations50Number per environment
App Access Grants1000Number per App Definition
Tags500Number per environment
Tags100Number per asset or entry

Technical limits are cumulative and can be reset only when an organization’s users delete individual items.

† There are two Premium plans: Premium and Premium Plus. Premium Plus customers can request higher rate limits through their Account Executive or Contentful support. For more information, see our pricing page.


Regardless of the pricing plan, we reserve the right to take corrective action, including but not limited to the throttling of the service API for short periods, when the stability of the system is at risk.