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

Roles (Permission Management in the Admin Panel)

Last updated: 2026/11/10

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.

Using the Role Management Screen

Role List Screen

On the role list screen, you can view the roles you have created and perform the following actions.

1. Search by Role Name

You can filter the list by role name.

2. Add a Role

Click the [Add] button to go to the screen for creating a new role.


The menu displayed when you click the three-dot menu for a role is as follows.

3. Copy a Role and Create a New One

You can copy the settings of the selected role to create a new role.
Click [Copy Role and Create New] to go to the screen for creating a new role. The selected role's settings are applied by default. Edit them as needed, then create the role.

4. Delete a Role

Deletes the selected role.

New Role Creation Screen

Use this screen to create a new role.

1. Create

Once you have configured the required items, click [Create] to create the role.

2. Clear All / Grant All

You can clear or select all checkboxes for each permission item.
When you add a Custom Permission, a [Clear All / Grant All] button is provided for each Custom Permission.

Information

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

Role Editing Screen

This screen lets you edit a role you created.

1. Copy and Create New

You can copy the selected role to create a new one.
This works the same way as clicking [Copy and Create New] on the role list screen.

2. Delete

Deletes the currently open role.

3. Save Changes

Applies the changes to 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 duplicated environments.

Review

Read

All Review Requests

You can view all Review Requests.

Only reviews created by members with this Role
You can view only reviews requested by members assigned the same Role.
The current Role is used to determine whether members belong to the same Role, not the Role they had when submitting the Review Request.

Only Review Requests I created

You can view only the reviews you requested.

None

You cannot view reviews.

Create

You can submit Review Requests.

Edit

Approve and edit

In addition to the "Edit" operations, you can approve reviews and delete comments.

Caution

With the “Approve and Edit” permission, you can approve Review Requests, but you cannot publish or unpublish approved Content (including scheduling these actions).

After approval, you need the following additional permissions for the Content to change its publication status:

  • Publish or schedule publication: “Publish / Schedule publication of approved Content”
  • Unpublish or schedule unpublishing: “Unpublish / Schedule unpublishing of approved Content”

Edit

You can edit the Review title and description, set Reviewers and a scheduled date and time, post comments, cancel the Review, and run or rerun an AI Review. 

None

You cannot approve or edit 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 primarily affects viewing the media list screen, reading images from the Rich Text Editor, and reading in image/file fields.

All Media

Information about all media (images and files) can be read.

Media Created by Members of This Role Only

You can only view media created by members assigned the same role. The current role is used to determine if you belong to the same role, not the role at the time of media creation.

Media Uploaded by Yourself Only

You can only view media that you have uploaded yourself.

None

You cannot view any media at all.

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.

Information

You can check the media Webhook settings by setting the media read permission to anything other than "None."
To edit the media Webhook settings, you need to set the media read permission to anything other than "None" and have edit permissions.

API

Read

Primarily affects viewing the API list displayed in the sidebar and reading Content Reference fields.
You can view information about all APIs.

Create

You can create APIs.

Edit

You can edit API Settings and Custom Field settings, reorder APIs, and move them between groups.

Delete

You can delete APIs.

Content

Read

Primarily affects viewing the Contents list and detail screens, and reading Content Reference fields.

All content

You can view all content.

Only content created by members with this role

You can view only content created by members assigned the same role.
The current role is used to determine whether members belong to the same role, not the role they had when the content was created.

Only content created by you

You can view only content you 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

[Actions that do not affect published content]

Save as draft

You can save content with the status “Draft” or “Published with a draft” as a Draft.

Discard draft

You can discard the Draft of content with the status “Published with a draft.”

Return unpublished content to draft

You can return content with the status “Unpublished” to Draft.

Change the Content ID of unpublished content

You can change the Content ID of content with the status “Draft” or “Unpublished.”

Reorder unpublished content

You can reorder content with the status “Draft” or “Unpublished.”

Change the publication date of unpublished content

You can change the publication date of content with the status “Draft” or “Unpublished.”

Change the content creator
You can change the content creator.

Change draftKey

You can change the draftKey of content with the status “Draft” or “Published with a draft.”

[Actions that affect published content]

Publish / schedule unapproved content

You can publish or schedule unapproved content with the status “Draft” or “Published with a draft.”

Publish / schedule approved content

You can publish or schedule approved content with the status “Draft” or “Published with a draft.”

Unpublish / schedule unpublishing of unapproved content

You can unpublish or schedule unpublishing of unapproved content with the status “Published” or “Published with a draft.”

Unpublish / schedule unpublishing of approved content

You can unpublish or schedule unpublishing of approved content with the status “Published” or “Published with a draft.”

Return published content to draft

You can return content with the status “Published” to Draft.

Change the Content ID of published content

You can change the Content ID of content with the status “Published” or “Published with a draft.”

Reorder published content

You can reorder content with the status “Published” or “Published with a draft.”

Change the publication date of published content

You can change the publication date of content with the status “Published” or “Published with a draft.”

Delete

You can delete content.

Developer menu

Read

You can hide developer settings. When hidden, the following menu items will also be hidden.

  • Custom Fields
  • API Settings
  • Preview API


▼How developer settings appear when set to “Show”



▼How developer settings appear when set to “Hide”

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 available by default and grants permission to perform all operations.
This role cannot be edited (its permissions cannot be changed) or deleted.
At least one member of the Service must be assigned this role.

Operations Available Only to the Administrator Role

Some operations in the Administration console can only be performed by members with the Administrator role.
Therefore, the Administrator role allows a broader range of operations than a newly created role with all permissions granted.

Examples of operations available only to the Administrator role include:

  • Viewing and managing certain Service settings
  • Creating, editing, and deleting API Keys
  • Changing Environment Names and label colors
  • Creating, renaming, and deleting API Groups
  • Assigning or editing roles other than the one you belong to
  • Enabling AI Features and individual features
  • Viewing the Review settings page
  • Adding, editing, and deleting AI Reviewers

Default Permissions and Custom Permissions

Default permissions are applied at the Service level and restrictions apply to all APIs and Content.
They are useful when you want to configure permissions for the entire Service at once.

In contrast, Custom Permissions are applied at the API level and can override default permissions.
With Custom Permissions, you can configure 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 as described above, the determination will be API creation permission granted.

Use Cases

How to assign or edit roles other than the roles you belong to

Members with a role other than the Administrator role are only allowed to perform the following actions related to assigning and editing roles:

  • Edit the permissions for a role they belong to
  • Assign or remove a role they belong to for another member


If you have a role other than the Administrator role and want to assign or edit a role you do not belong to, assign that role to the relevant member. Multiple roles can be assigned to a member, and the role with the higher level of permissions takes precedence.

Example: Adding a member with a role you do not belong to

Suppose there are two roles, “Site A Administrator” and “Site A Operator,” and a member has the “Site A Administrator” role.



Now, suppose this member wants to add a member with the “Site A Operator” role, which they do not have.
In this case, assigning the “Site A Operator” role to this member will allow them to select that role when adding a member.



▼ “Site A Operator” will also be available for selection when adding a member

Contents

  • Using the Role Management Screen
  • 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 assign or edit roles other than the roles you belong to
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.