microCMS

Tutorial
Next.js
Nuxt 3
Nuxt 2
Gatsby
Astro
Remix
JavaScript
PHP
Ruby
Go
iOS
Android
Manual
Account & Login
Services
Payment
API
Fields
Contents
Rich Editor
Reviews
Media
Permission Management
Connection
Logs
Security
Authentication
Specifications & Limitations
Content API
Basic Operations
API Keys
Responses & Error Handling
Management API (Beta)
Content Operations
Media Operations
Member Operations
API Operations
Service Operations
Responses & Error Handling
Image API
Parameters
MCP Server

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
informationInformation
  • 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
informationInformation
  • 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
informationInformation
  • 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
informationInformation
  • 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

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