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

Roles (Permission Management in the Admin Panel)

Last updated: 2026/07/03

The role feature allows you to flexibly set operation permissions for members in the management screen.
Please use it when multiple members from different positions are managing content simultaneously, or when you want to set operation permissions by department or store.

Information

The role is a feature available in the Business and Enterprise plans.
For details on the features available in each plan, please refer to the pricing page.

Role Management Screen Operations

Role List Screen

On the role list screen, you can view the roles you have created, as well as perform the following various operations.

1. Search by Role Name

You can filter by role name.

2. Add a Role

Press the [Add] button to navigate to the new role creation screen.


Additionally, the menu that appears when you press the three-dot menu for each role is as follows.

3. Copy Role to Create New

You can copy the settings of the selected role to create a new role.
Press [Copy Role to Create New] to navigate to the new role creation screen, where the settings of the selected role will be reflected in their initial state. Please make any necessary edits and create the role.

4. Delete Role

This will delete the selected role.

New Role Creation Screen

This is the screen for creating a new role.

1. Create

Once you have completed the necessary settings, press [Create] to create the role.

2. Deselect All / Grant All

You can deselect all or grant all for each permission item.
When individual permissions are added, a [Deselect All / Grant All] button will be provided for each individual permission.

Information

For individual permissions, please refer to the section on "Default Permissions and Individual Permissions" below.

Role Editing Screen

This is the screen for editing the created roles.

1. Copy and Create New

You can copy the selected role and create a new role.
This behaves the same as when you press [Copy and Create New] on the role list screen.

2. Delete

This will delete the currently opened role.

3. Change

This will reflect the changes in the role settings.

Details of Each Permission Item

This section explains the details of various permissions that can be set using the role feature.

Members

Read

This mainly affects the viewing of the member list screen and detail screen, as well as the reading of reviewer, creator, updater information, and members currently editing.

All Members

Information about all members can be read.

Members with this role assigned
Information about members assigned the same role can be read.

Specific Members Only

Information about specified members can be read.

None

Members cannot be viewed.

Create

Members can be created.

Caution

When creating a member, it is necessary to specify a role, so read permissions for the role are also required.

Members other than the administrator role can only specify the roles they belong to.

If you want to specify a role for the member that is not one you belong to, please assign that role to yourself.

For specific methods, please refer to "How to grant or edit roles other than the ones you belong to".

Edit

You will be able to change the roles associated with members.

Caution

You will need read permissions for the role.

Members other than those with the administrator role can only change the roles they belong to.

If you want to change a role that you do not belong to, please assign that role to yourself.

For specific methods, please refer to "How to grant or edit roles other than the ones you belong to".

Delete

You will be able to delete members.

Roles

Read

This mainly affects viewing the role list and role detail screens.

All Roles

You will be able to read information about all roles.

Read (Only roles I belong to)

You will be able to read information about the roles you belong to.

None

You will not be able to view roles.

Create

You will be able to create roles.

Edit

You will be able to edit the permissions of roles.

Caution

Members other than the administrator role can only edit the permissions of the roles they belong to, even if they have editing rights.

If you want to edit the permissions of a role that you do not belong to, please assign that role to yourself.

For specific instructions, please refer to "How to assign or edit roles other than the ones you belong to".

Delete

You will be able to delete roles.

Payment

Read

You will be able to access the payment settings screen.
You can check your current plan and billing information.

Edit

You will be able to change your plan and update your billing information.

Caution

Essentially, changing to the Hobby plan grants the authority to stop the service.

API Key

Read

This mainly affects viewing the API Key list screen, detail screen, and reading the API Key during API Preview.
All information regarding API Keys will be accessible for reading.

Usage Confirmation

Read

You can access the data transfer amount screen and content count screen in Service Settings.

Environment

Read

All Environments

You can view the list of duplicate environments and access all environments.

Only environments with known URLs (not recommended)

The list of duplicate environments will not be displayed, but you can access them directly if you know the URL.
This setting is equivalent to the traditional read permission. If you want to restrict access to environments more strictly, it is recommended to set it to "None" or "Only specific environments."

Caution

If you are using SAML authentication, you cannot access the URL directly even if you know it.

Specific Environments Only

Only the explicitly specified environments can be listed and accessed. Environments that are not specified cannot be accessed even if the URL is known.

None

Access to duplicate environments is not allowed. Access is also not permitted if the URL is specified directly.

Create

You can create a duplicate environment.

Caution

When creating an environment, having creation permissions allows you to verify a lot of data, as it enables the copying of settings and content from the production environment.

Delete

You can delete the duplicated environment.

Review

Read

All Review Requests

You can view all review requests.

Only reviews created by members of this role
You can only view reviews requested by members assigned the same role.
The determination of whether members belong to the same role is based on the current role, not the role at the time of the review request.

Only Review Requests I Created

You can only view reviews that you have requested.

None

You cannot view any reviews.

Create

You can submit a review request.

Edit

Approve + Edit/Comment

In addition to the operations possible with "Edit/Comment only," you can approve the review and delete comments (including comments from AI Review).

Caution

With the "Approve + Edit/Comment" permission, you can approve reviews, but you cannot publish, schedule for publication, end publication, or schedule to end publication at the time of approval.

To change the publication status, the following permissions are additionally required for the target content.

  • Publish/Schedule for Publication: "Publish/Schedule Approved Content"
  • End Publication/Schedule to End Publication: "End Publication/Schedule Approved Content"

Edit and Comment Only

You can complete, reapply, post comments, edit the review title and description, set the scheduled time, configure the reviewer, assign the AI Reviewer on the review screen (manual execution), and execute a re-review.

No Editing

No edits can be made regarding the review.

Information

Permissions for Executing AI Review
To manually execute (or re-review) an AI review, in addition to the review permissions mentioned above, you must have “read permissions for all content related to the review target”.
If there is any data within the target content, such as referenced content or image data, for which you do not have read permissions, you will not be able to manually execute (or re-review) the AI review.

※Note that if "Automatic Review" is set to ON in the review settings, the execution will be performed by the system, and it can be executed regardless of the operator's permissions.

Media

Read

This mainly affects viewing the media list screen, reading images from the Rich Text Editor, and reading in image/file fields.

All Media

You will be able to read information about all media (images and files).

Media Created by Members of This Role Only

You can only view media created by members assigned the same role. The determination of whether they belong to the same role uses the current role, not the role at the time of media creation.

Media Uploaded by Yourself Only

You can only view media that you have uploaded.

None

You cannot view any media.

Create

You will be able to upload media.

Edit

You will be able to re-upload media, change file names, and set tags.

Delete

You will be able to delete media.

API

Read

This mainly affects reading the API list displayed in the sidebar and reading content reference fields.
You can view information about all APIs.

Create

You will be able to create APIs.

Edit

You will be able to configure API settings, set custom fields, and rearrange or move APIs between groups.

Delete

You will be able to delete APIs.

Content

Read

This mainly affects viewing the content list screen and detail screen, as well as reading content reference fields.

All Content

You can view all content.

Content Created by Members of This Role Only

You can only view content created by members assigned the same role. The determination of whether they belong to the same role uses the current role, not the role at the time of content creation.

Content Created by Yourself Only

You can only view content that you have created.

None

You cannot view any content.

Create

Save as Draft

You can save new content as a draft.

Publish

You can publish new content.

Edit

[Operations Not Affecting Published Content]

Save as Draft

You can save content that is "Draft" or "Published and Draft" as a draft.

Discard Draft

You can discard the draft of content that is "Published and Draft".

Revert Unpublished Content to Draft

You can revert "Published Ended" content to draft.

Change Content ID of Unpublished Content

You can change the content ID of content that is "Draft" or "Published Ended".

Rearrange Unpublished Content

You can rearrange content that is "Draft" or "Published Ended".

Change Publish Date of Unpublished Content

You can change the publish date of content that is "Draft" or "Published Ended".

Change Content Creator
You can change the content creator.

Change draftKey

You can change the draftKey of content that is "Draft" or "Published and Draft".

[Operations Affecting Published Content]

Publish / Schedule Publication of Unapproved Content

You can publish or schedule publication of unapproved content that is "Draft" or "Published and Draft".

Publish / Schedule Publication of Approved Content

You can publish or schedule publication of approved content that is "Draft" or "Published and Draft".

End Publication / Schedule End Publication of Unapproved Content

You can end publication or schedule end publication of unapproved content that is "Published" or "Published and Draft".

End Publication / Schedule End Publication of Approved Content

You can end publication or schedule end publication of approved content that is "Published" or "Published and Draft".

Revert Published Content to Draft

You can revert "Published" content to draft.

Change Content ID of Published Content

You can change the content ID of content that is "Published" or "Published and Draft".

Rearrange Published Content

You can rearrange content that is "Published" or "Published and Draft".

Change Publish Date of Published Content

You can change the publish date of content that is "Published" or "Published and Draft".

Delete

You can delete content.

Developer Menu

Read

You can hide developer settings. If set to hidden, the following menus will not be displayed.

  • Custom Fields
  • API Settings
  • API Preview


▼View When Developer Settings are Set to "Visible"



▼View When Developer Settings are Set to "Hidden"

Caution

You can view Custom Fields and API Settings by directly entering the URL. The Developer Menu is intended for basic control, so if you need to restrict actual access, please use the permission settings related to the API.

Permission Priority

About the Administrator Role

The Administrator role is a default role that has permissions for all operations.
This role cannot edit (change permission contents) or delete.
Additionally, it must be assigned to at least one member within the Service.


Operations Executable Only by the Administrator Role

There are operations in the Administration console that can only be executed by the Administrator role.
Therefore, when comparing a newly created role with all permissions granted to the Administrator role, the Administrator role can perform a wider range of operations.

Operations that can only be executed by the Administrator role include the following:

  • Viewing and operating certain items in Service Settings
  • Creating, editing, and deleting API Keys
  • Changing environment names and label colors
  • Creating, editing, and deleting API Groups
  • Granting and editing roles other than the one they belong to
  • Enabling AI Features and individual functionalities
  • Displaying the Review Settings screen
  • Adding, editing, and deleting AI Reviewers

Default Permissions and Custom Permissions

Default permissions are permissions applied at the service level, and restrictions are applied to all APIs / contents.
This is effective when you want to set permissions for the entire service at once.

On the other hand, custom permissions are permissions applied at the API level, which can override default permissions.
With custom permissions, you can set the following items:

  • API
  • Content
  • Developer Menu
  • Review

Behavior When Multiple Roles Are Assigned

Multiple roles can be assigned to a single member.
The association of roles to a member can be done from the member detail screen.

If the multiple roles assigned have different permissions, the role with broader permissions takes precedence.

Information

Role A: No API creation permission
Role B: API creation permission granted

If a user belongs to both roles, the determination will be API creation permission granted.

Use Cases

How to Grant or Edit Roles Other Than Your Own

Members with roles other than the Administrator role are only permitted to perform the following actions regarding role assignment and editing.

  • Edit the permissions of the role they belong to
  • Grant or revoke their own role to/from another member


If you hold a role other than the Administrator role and wish to grant or edit roles other than your own, please assign the relevant role to the corresponding member. Roles can be assigned to multiple members, and stronger permissions take precedence.

Example of Adding a Member with a Role You Do Not Belong To

Assume there are two roles: "Site A Administrator" and "Site A Operator," and there is a member with the "Site A Administrator" role.



Now, consider the case where this member wants to add a member with the "Site A Operator" role (a role they do not possess).
In this case, by granting the "Site A Operator" role to this member, they will be able to select the "Site A Operator" role when adding a member.



▼ When adding a member, the "Site A Operator" role will also be selectable

Contents

  • Role Management Screen Operations
  • Role List Screen
  • New Role Creation Screen
  • Role Editing Screen
  • Details of Each Permission Item
  • Members
  • Roles
  • Payment
  • API Key
  • Usage Confirmation
  • Environment
  • Review
  • Media
  • API
  • Content
  • Developer Menu
  • Permission Priority
  • About the Administrator Role
  • Default Permissions and Custom Permissions
  • Behavior When Multiple Roles Are Assigned
  • Use Cases
  • How to Grant or Edit Roles Other Than Your Own
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.