- Help center home
- Getting started
- Content model
- Managing content
- Working with entries
- Working with media
- Working with translations
- Managing users
- Roles
- Account settings
- Administration
- Content orchestration
- Compose
- Launch
- Workflows
- How to get help and support
- Guides
- Contentful certification
- Contentful glossary
- Cookie consent
- Apps
- Usage Limit
Creating a custom role
On this page
Custom roles can be created by space administrators under Settings > Roles & Permissions.
Note: Custom roles are only available for space sizes P1X and above on the Premium/Enterprise plan. For more details, organization owners and admins can check their subscription plan.

The Roles & permissions screen
Navigate to space settings by clicking the Settings tab and selecting Roles & Permissions.
Click Create a new role and give the role a name and description.
Under Content click the “Add rule” link. A new row of dropdown menus will appear to help refine the permission.

A new role with no permissions assigned
For the Proofreader role, we want to have the following requirements:
A Proofreader can read any entry that is a Product
A Proofreader can edit the “Product name” field of any entry that is a Product, regardless of locale
A Proofreader can edit the “Description” field of any entry that is a Product, regardless of locale
NOTE: By default, actions are denied. You must explicitly grant permission to actions you want a role to have. In our example, this includes the ability to read entries where edit permissions are granted.
Putting these requirements into the role configuration looks like this:
Action | Which entries | Content type | Field | Locale |
---|---|---|---|---|
Permissions for the Proofreader role
Once you are satisfied with the role permissions, click Save changes. The Proofreader role is now created.

Assign existing users to roles
With our custom role created, the next step to enabling field-level permissions is to assign users to the role. (If you want to assign a user to a role who is not currently part of your organization, see inviting new users.)
Go to Settings > Roles & Permissions. Under the Members column, click the link indicating the number of members for the role you want to assign users to. The Users management page will open.

2. Click Add users to bring up the list of users for the organization. Select one or more users and then click Assign roles to selected users.

One user (“Organization Member”) is selected for adding to the space.
On the next step, select the role that should be assigned to the user, then click Add selected users. For this example the Proofreader role is selected.

The user will receive an invitation to the space and will show up on the Users page as a Proofreader.
