Configure and assign roles
Roles define a set of permissions that you can assign to your users within a project. Configuring roles is an important part of setting up your Kontent project.
You can create roles for different groups of users, such as content contributors, reviewers, developers, and more. Invite users to your project and give them specific permissions that other users don't have.
Table of contents
Roles apply to everyone so to configure roles in your project, you'll need the Manage custom roles permission.
Add new roles
By default, there's only the Project manager role in Kontent, allowed to do anything. Add a new role when you want to customize permissions.
- From the app menu, choose Project settings.
- Under Project settings, switch to Roles.
- Click Create new.
- Name the new role, for example, Copywriter.
- Select the permissions for the role, such as View, edit, create, and delete all content items.
- Check out what each permission does in the permission reference.
- Click Save changes.
After creating the custom role for content contributors, you can assign it to your existing users or invite new users with this role pre-assigned.
Delete roles
You can delete a custom role if:
- The role is not assigned to any active user (assign them a different role instead or deactivate the user).
- The role is not used as a limitation in any workflow step.
To delete a role:
- From the app menu, choose Project settings.
- Under Project settings, switch to Roles.
- Click on a custom role to open it.
- Click Delete.
The role has been deleted from your project. If you're within your plan limits, you can undo the deletion.
You cannot delete the Project manager role from your project.
Assign roles to users
- From the app menu, choose Project settings.
- Click a user to open their user details.
- Set the desired role.
- Click Save.

Check your role in projects
To check your role, click your initials in the bottom left corner and choose Projects.
The Projects screen shows which role you were assigned in each project.

What's next?
- Set up a workflow for your project and see how roles and content workflow can work together to your team's benefit.
- Find out what different role permissions allow your users to do within a project.
- Change the roles of your existing users.
- Use the new custom roles when inviting users to your project.