Top
Manual

Limitations / Precautions

Last updated: 2026/04/24

Limitations

Limitations Regarding the Management Screen

Data size per content: approximately 200KB
Input upper/lower limits for numeric fields: 9007199254740991 /-9007199254740991

Information

You can check the current data usage at the top of the editing screen under "Content Available Space."
The content size holds values for two states when it is "Published and Draft," making it the largest. In the cases of "Published," "Draft," and "Published End," it can hold approximately 400KB, which is double.
The calculation of content size also includes information stored in the database internally, such as field types and rich editor structure information.

Limitations Regarding the Content API

GET API rate limit (per service): 60 requests / 1 second
WRITE API (POST / PUT / PATCH / DELETE) rate limit (per service): 5 requests / 1 second

Information

The rate limit is counted as a total per service. The count is based on the number of accesses to the origin. Responses from the Content API are sent via the CDN, so if they are returned from the edge server's cache, they will not count towards the limit. (For conditions on cache usage, please refer to the help.)
Due to the multi-tenant system, even if you are within the rate limit, you may occasionally receive status code 429 (Too Many Requests) or 500 series errors depending on the overall request situation. Implementing retry logic can reduce the occurrence of these errors. For more details, please refer to the help.
Since a Web Application Firewall (WAF) is in place, requests deemed malicious may be blocked regardless of the rate limit.
If the rate limit is exceeded, status code 429 (Too Many Requests) will be returned. In that case, the API response will include the following headers.

X-RateLimit-Limit: 60 # Number of requests allowed per second
X-RateLimit-Remaining: 13 # Number of remaining requests allowed
X-RateLimit-Reset: 1648014262 # Time when the request count will be reset (UNIX time)

Maximum request body size for POST / PUT API: approximately 300KB
Maximum request body size for PATCH API: approximately 90KB
Maximum length of request URL: 8KB
Maximum response size: approximately 5MB
Maximum response time: approximately 29 seconds

Information

If the maximum response time is exceeded for requests with complex filtering conditions, a 500 series status code error will be returned.

Limitations of the Management API (Beta)

Rate limit (per IP address): 10 requests / 10 seconds

Information

The rate limit is counted based on the total per IP address. Responses from the Management API are counted directly as they do not go through the CDN.
Due to the multi-tenant system, even if you are within the rate limit, you may occasionally receive status codes 429 (Too Many Requests) or 500 series errors depending on the overall request situation. Implementing retry logic can reduce the occurrence of these errors. For more details, please refer to the help.
Since a WAF (Web Application Firewall) is implemented, requests deemed malicious may be blocked regardless of the rate limit.
If the rate limit is exceeded, a status code 429 (Too Many Requests) will be returned.
As this is a beta version, additional constraints may be added as necessary.

Limitations Vary by Pricing Plan

The following items have different limitations depending on your current pricing plan.
Please check the pricing plan page for more details.

Data transfer volume
Number of members
Number of APIs
Number of API keys
Number of contents
Number of views
Number of CSV imports
Storage per media
Number of IP restrictions (admin panel) that can be set
Number of IP restrictions (API) that can be set per API

Items Without Set Limitations

microCMS has items that do not have specific limitations. Examples include the following:

Number of services
Number of fields
Number of Custom Fields
Number of items in select fields
Number of roles
Number of media
Number of members (limit when exceeded)
Number of APIs (limit when exceeded)
Number of content update history displays

We have confirmed that these values generally do not pose issues within typical usage. However, if an unusually high number is set, there may be cases where normal operation is not guaranteed.

If you encounter any problems, we kindly ask you to contact us via the chat section at the bottom right of the screen.

Notes

About Beta Features

Beta features may be less stable than regular features. Additionally, there is a higher likelihood of disruptive changes that do not maintain compatibility compared to stable features.

Please consider the risks of potential instability and changes before deciding to use these features.

Currently Available Beta Features

Management API

Items Without Detailed Descriptions

microCMS has items that do not have detailed descriptions. Examples include the following:

API response headers
Status codes for API errors
Webhook request headers

These items are expected to operate in accordance with standard specifications of various technologies such as web, internet, and HTTP. Additionally, there may be changes in operation within the scope of these specifications.

If you have any questions, please contact us via the chat section at the bottom right of the screen.

Contents

Limitations
Limitations Regarding the Management Screen
Limitations Regarding the Content API
Limitations of the Management API (Beta)
Limitations Vary by Pricing Plan
Items Without Set Limitations
Notes
About Beta Features
Items Without Detailed Descriptions