Configure and assign roles
Roles define a set of permissions that you can assign to users within a project. If you're not sure what permissions your users need, see how to establish roles for your users first.
You can create roles for different groups of users, such as content contributors, reviewers, developers, and more. Roles apply to everyone so to configure roles in your project, you'll need the Manage custom roles permission.
Table of contents
Add new roles
By default, there's only the Project manager role in Kontent.ai, allowed to do anything. Add a new role when you want to customize permissions.
- In Project settings, select 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:
- In Project settings, select 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
Users can have different roles in each collection and language. This influences what content they can see and work on.
- In Project settings, select Users.
- Click a user to open their 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.
