microCMS
Documentation
  • Pricing
  • Blog
  • FAQ
  • Contact
  • Sign In
  • Get started for free
Navigation
Tutorial
Next.js
  • Integration with Next.js
  • Getting Started with App Router
  • Tutorial (App Router)
  • Getting Started with Pages Router
  • Tutorial (Pages Router)
Astro
  • Getting Started
  • Integration with Astro
  • Tutorial
Nuxt
  • Integration with Nuxt
  • Getting Started
  • Tutorial
Gatsby
  • Integration with Gatsby
  • Getting Started
  • Tutorial
JavaScript
  • Integration with JavaScript
  • Getting Started (Browser)
  • Getting Started (Server)
PHP
  • Integration with PHP
  • Getting Started
Ruby
  • Integration with Ruby
  • Getting Started
Go
  • Integration with Go
  • Getting Started with microCMS
Manual
  • Introduction
Account & Login
  • Account Registration
  • Login
  • Email Address Authentication
Services
  • Creating a Service
  • Service Configuration
  • Template
  • Service Deletion
Payment
  • Change of Pricing Plan
  • Registering and Changing Payment Methods
API
  • Creating and Managing APIs
  • API Settings
  • Export/Import of API Schema
Fields
  • Text Field
  • Text Area
  • Image
  • Multiple Images
  • Date
  • Boolean
  • Selectable Field
  • Content Reference
  • Multiple Content References
  • Number
  • File
  • Extended Field
  • Repetition
  • Custom
Contents
  • CSV Export of Content
  • Content Creation
  • Content Editing
  • Content Management
  • View
  • Content Status
  • Custom Status
  • Setting the Content ID
  • Automatically Assigned Values for Content
  • CSV Import of Content
  • API Preview
  • Examples of Using Query Parameters with API Preview
  • Integration Methods by Rendering Type
  • Screen Preview
  • Setting Up Webhooks for Content
Rich Editor
  • How to Use the Rich Editor
  • Rich Editor WRITE API
  • How to Use the Old Rich Editor
Reviews
  • Review
  • AI Review
Media
  • Media Management
  • Changing Media Filters and Display Order
  • Media Tag Configuration
  • Setting Up Media Webhooks
  • Custom Domain Settings for Media
Permission Management
  • Member Management
  • Roles (Permission Management in the Admin Panel)
Environments
  • Multiple Environments (Development Environment)
  • Merging API Settings Between Environments
Connection
  • Amazon S3 Integration
Logs
  • Audit Log
  • Data Transfer Volume
Security
  • Content Update History
  • IP Restrictions for Management Dashboard
  • IP Restrictions for APIs
Authentication
  • Setting Up Two-Factor Authentication
  • Mandatory Two-Factor Authentication
  • Single Sign-On
Specifications & Limitations
  • Recommended Environment
  • Limitations / Precautions
Content API
  • What is the Content API?
Basic Operations
  • GET /api/v1/{endpoint}
  • GET /api/v1/{endpoint}/{content_id}
  • POST /api/v1/{endpoint}
  • PUT /api/v1/{endpoint}/{content_id}
  • PATCH /api/v1/{endpoint}/{content_id}
  • DELETE /api/v1/{endpoint}/{content_id}
API Keys
  • API Key (API Authentication and Authorization Management)
  • Migration from the Old API (X-API-KEY, etc.)
Responses & Error Handling
  • Response format for each field in the GET API
  • Specifying Query Parameters in the GET API
  • Error Responses of the Content API
Management API (Beta)
  • POST /api/v1/roles
  • DELETE /api/v1/roles/{role_id}
  • GET /api/v1/roles/{role_id}
  • PATCH /api/v1/roles/{role_id}
  • GET /api/v1/roles
  • What is the Management API?
Content Operations
  • PUT /api/v1/contents/{endpoint}/{content_id}/reservation
  • GET /api/v1/contents/{endpoint}
  • GET /api/v1/contents/{endpoint}/{content_id}
  • PATCH /api/v1/contents/{endpoint}/{content_id}/status
  • PATCH /api/v1/contents/{endpoint}/{content_id}/createdBy
Media Operations
  • GET /api/v2/media
  • GET /api/v1/media
  • POST /api/v1/media
  • DELETE /api/v2/media
Member Operations
  • PATCH /api/v1/members/{member_id}
  • GET /api/v1/members
  • GET /api/v1/members/{member_id}
API Operations
  • POST /api/v1/apis
  • GET /api/v1/apis
  • GET /api/v1/apis/{endpoint}
Service Operations
  • GET /api/v1/service
Responses & Error Handling
  • Management API Error Responses
Image API
  • What is the Image API?
Parameters
  • Image Size
  • Quality
  • Resolution and Screen Size
  • Format
  • Text
  • Border
  • Padding
  • Shape
  • Download
  • Watermark
MCP Server
  • microCMS MCP
  • microCMS Document MCP Server
  • Top
  • Manual

Review

Last updated: 2026/11/10
Information

This document reflects the release of “Separating Review Approval from Publishing,” which is scheduled to roll out gradually starting November 10, 2026.

You can request a review from members before publishing or scheduling Content, or unpublishing or scheduling its unpublication.
Once a review has been created, you can publish or unpublish the Content (including scheduling either action) after it has been approved by the members designated as Reviewers.

Information
  • Review is available on all plans.
  • In addition to reviews by human members, we offer an AI Review feature that helps check content quality. For instructions on configuring and using AI Review, see the AI Review manual.

Review Workflow

Reviews follow this workflow:

  1. Submit a review request from the content editing screen.
  2. Assign reviewers. Reviewers review the content by checking its contents and differences, and adding comments.
  3. Once any one reviewer approves the review, its status changes to "Awaiting application."
    1. Approving a review alone does not finalize the publication or unpublishing of content (including scheduled publication or unpublishing).
  4. Publish or unpublish the content (including scheduling either action).

Review Status

Status

Description

Pending

A Review Request has been submitted and is awaiting approval.

Awaiting application

The required number of approvals (1) has been met, and the review is awaiting the application of the publication or unpublication (including scheduled changes).

Completed

The publication or unpublication (including scheduled changes) has been applied, or the review has been canceled.

When a scheduled action is applied, the review ends at that point. The content will be published or unpublished at the scheduled date and time.

Submit a Review Request

On the content editing screen, click [Review Request].



On the review creation screen, enter a title and description. The title is required. Including details about what you want reviewers to check or the purpose of the changes will help them understand the content.



After entering the details, click [Submit] to go to the review details screen.

Content You Can Submit for Review

You can submit the following types of reviews depending on the content status.

Review Type

Eligible Content

Publication Review

Draft / Published and Draft

Unpublishing Review

Published

From Request to Application

The labels displayed on Content vary depending on the type of Review.

Review Type

Label displayed on Content while the request is pending

Label displayed on Content after approval

Action after approval

Publish Review

Publish Review Request Pending

Awaiting Publication

Publish / Schedule Publication

Unpublish Review

Unpublish Review Request Pending

Awaiting Unpublication

Unpublish / Schedule Unpublication

Caution

As a general rule, you cannot submit content with a schedule set for review.

However, if the content is published and has a draft, and only a scheduled unpublishing is set, you can submit the draft for a publication review.

Information

To submit a review request for published content, first revert the content to Draft.

Assign Reviewers

In the Review details screen, select the members you want to request a review from under “Reviewers.” You can search by member name and assign up to 10 reviewers. You can also assign yourself as a reviewer when submitting a Review Request.



You can check each member’s approval status by the “Pending” or “Approved” label. Members who have approved the review cannot be removed as reviewers.

Information
  • Reviewer candidates are displayed based on the “Member read permission” of the member requesting the review. Members who do not have permission to view the review in question are not displayed as candidates.
  • You can assign members who do not have approval permission as Reviewers. However, to actually approve a Review, they need the “Approve and edit” permission to edit Review Requests.

Using AI Review

Members with the Administrator role can manage AI Reviewers from [Review Settings] on the Review screen.



Using AI Reviewers lets you receive feedback on Content as comments.
AI Review results are not counted toward the number of approvals by members. Member approval is required to proceed with publishing or unpublishing.
For setup instructions and details on how to use this feature, see AI Review.

Review the Content

Review Content Differences

When a publishing review is “Pending,” you can compare the published content with the latest draft in the “Changes” tab. If there is no published content, the draft is compared with empty content. This tab is not displayed when the review status is “Awaiting application” or “Completed.”



If the content is updated while under review, you can also compare the content before and after the update by selecting [Content updated: v○→v○] in the Review tab.

Caution
  • When checking for empty values, differences may be treated as no difference even when the data is technically different. This does not necessarily guarantee that the API response will contain no differences.

Commenting

You can share revision requests and review results in the comment section on the review details screen.
Available actions, such as posting and deleting comments, depend on the permissions assigned to your Role.
Feedback from AI Review is also displayed in this comment section.

Approve a Review

Members designated as reviewers should review the content and, if everything looks good, click [Approve].



Currently, one approval is required. Even if multiple reviewers are designated, once any one of them approves, the status changes to “1/1 approved,” and the review moves to “Pending application.”


Information
  • To click [Approve], you need the “Approve and edit” permission for Review Requests. You do not need permission to publish or unpublish approved Content, including scheduling publication or unpublishing.

If You Need to Edit Content After Approval

Content that is “Pending application” is locked and cannot be edited.



Depending on the type of Review, the Content is labeled “Pending publication” or “Pending completion.”
If you need to make changes after approval, cancel the Review, edit the Content, and then submit a new Review Request.

Publish or Unpublish Approved Content (Including Scheduled Publishing and Unpublishing)

Publish or Unpublish Content

Once the Review Status is "Awaiting changes to be applied," you can publish or unpublish the content.
On the Review details screen, click the button that corresponds to the request.
After the action is completed, the review status changes to "Completed."

Review Type

Button

Action

Publish Review

Publish

Publish the draft content

Unpublish Review

Unpublish

Unpublish the content

Schedule Publishing and Unpublishing

You can schedule when content is published or unpublished from the Review details screen.
Open “Scheduled publishing date” or “Scheduled unpublishing date” on the Review details screen, enter a date and time, and click [Set].



When the Review status changes to “Pending application,” click the button corresponding to the request.

Review Type

Button

Configurable Date and Time

Publication Review

Schedule Publication

Scheduled Publication Date and Time / Scheduled Unpublication Date and Time

Unpublication Review

Schedule Unpublication

Scheduled Unpublication Date and Time

Setting the date and time or approving a Review alone does not confirm the schedule. Complete the publish or unpublish scheduling action before the scheduled date and time.
Once you schedule publishing or unpublishing, the Review status changes to “Ended.”

Information
  • The following permissions are required to publish or unpublish content (including scheduling) from the Review details screen:
    • Publish / Schedule publication: Publish or schedule publication of approved Content
    • Unpublish / Schedule unpublication: Unpublish or schedule unpublication of approved Content
  • Members other than Reviewers can also publish or unpublish content (including scheduling)

Cancel a Review

If you decide not to publish the Content or want to edit it after approval, click [Cancel Review] on the review details screen.
Click [Cancel] on the confirmation screen to end the Review without applying it to the Content. You can cancel a Review whether its status is "Pending" or "Awaiting application."
You cannot resume a canceled Review. To submit the Content for Review again, create a new Review Request from the Content editing screen.

Information
  • Any member with the “Edit” or “Approve and edit” permission for the review can cancel it, not just the requester or reviewer.

Find Reviews

Open the list of reviews from “Review” in the left menu of the Administration console.



You can filter the list by the following criteria.

Menu

Reviews to Display

All

Reviews you can view

Requested by Me

Reviews you requested

Assigned to Me

Reviews for which you are designated as a Reviewer

You can check each status in the “Pending,” “Awaiting changes,” and “Completed” tabs. The “Completed” tab is not available under “I’m an approver.”

Restrictions on Actions for Content Under Review

The following actions are restricted for Content under review. These restrictions are lifted once the Review is complete.

Action

Public Review Request Pending

Unpublish Review Request Pending

Pending Application

Edit and save content

You can edit and save the Draft

You can edit and save the Published content

Not allowed

Publish from the content details screen

Not allowed

Only updates to Published content are allowed*

Not allowed

Unpublish from the content details screen

Not allowed

Not allowed

Not allowed

Schedule publishing or unpublishing from the content details screen

Not allowed

Not allowed

Not allowed

Delete content

Not allowed

Not allowed

Not allowed

※If the end-of-publication Review is “Pending,” you can update the published Content using the [Publish] button on the Content details screen.

Configure Permissions

Review approval and publishing or ending publication of approved Content (including scheduling) are managed by separate Permissions.
To perform actions on the Review details screen, you must be able to view the relevant Review.

Action

Primary Permission Required

Submit a Review Request

Permission to create Review Requests

Edit the request, comment, or cancel the review

Either “Edit” or “Approve and Edit” under Review Request editing permissions

Delete comments (your own or other members’)

“Approve and Edit” under Review Request editing permissions

Approve a review

“Approve and Edit” under Review Request editing permissions

Publish or schedule publication after approval

“Publish / Schedule publication of approved Content” under Content editing permissions

Unpublish or schedule unpublishing after approval

“Unpublish / Schedule unpublishing of approved Content” under Content editing permissions

To approve a review, a user must have the required permissions and be designated as a Reviewer. Reading permission for the relevant Content is also required to publish or unpublish it after approval.
For example, you can assign permissions as follows to separate approval and publishing responsibilities.

  • Approver: Grant permission to “Approve and edit” Review Requests, and designate the user as a Reviewer.
  • Publisher: Grant the permissions required to publish or unpublish approved Content, including scheduling. The user does not need to be designated as a Reviewer.

For instructions, see Roles (Administration console permission management).

Email Notifications

Emails like the one below are sent to relevant members when actions are taken, such as assigning a Reviewer, posting a comment, canceling a Review, or publishing or unpublishing Content (including scheduled actions).



When any of the following actions are completed, an email is sent to the relevant members. In all cases, the person who performed the action will not receive an email.

Action

Recipients

Notification Timing and Details

Add a Reviewer

Added member

When added, the member is notified that they have been assigned as a Reviewer.

Comment posted by a member

Requester and all Reviewers

When posted, the comment is sent in the notification.

Approval moves the review to "Pending application"

Requester only

When approved, the requester is notified that the review was approved and moved to "Pending application."

Additional approval after the review moves to "Pending application"

Requester only

When the additional approval is granted, the requester is notified that the review was approved.

Cancel a review

Requester and all Reviewers

When the review is marked as "Completed" due to cancellation, recipients are notified that it was canceled.

Publish or unpublish Content

Requester and all Reviewers

When publishing or unpublishing is applied from the review details screen, recipients are notified that the review has ended and the Content has been published or unpublished.

Schedule publication or unpublication of Content

Requester and all Reviewers

When a schedule is applied from the review details screen, recipients are notified that the review has ended and the schedule has been set.

Contents

  • Review Workflow
  • Review Status
  • Submit a Review Request
  • Content You Can Submit for Review
  • From Request to Application
  • Assign Reviewers
  • Using AI Review
  • Review the Content
  • Review Content Differences
  • Commenting
  • Approve a Review
  • If You Need to Edit Content After Approval
  • Publish or Unpublish Approved Content (Including Scheduled Publishing and Unpublishing)
  • Publish or Unpublish Content
  • Schedule Publishing and Unpublishing
  • Cancel a Review
  • Find Reviews
  • Restrictions on Actions for Content Under Review
  • Configure Permissions
  • Email Notifications
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.