Create roles and assign permissions

In the Clerk Dashboard, you can create roles, assign permissions to them, and change users' roles.

Create a new role for your organization

1. In your Clerk Dashboard, navigate to Organization Settings(opens in a new tab) and select the roles tab.
2. Select Create new role.
3. Give the role a name, a key to reference it by in the format org:<role>, and a description.
4. Select Create role.

Create a new permission for your organization

1. In your Clerk Dashboard, navigate to Organization Settings(opens in a new tab) and select the Permissions tab.
2. Select Create new permission.
3. Give the permission a name, a key to reference it by in the format org:<resource>:<action>, and a description.
4. Select Create permission.

Change a user’s role in an organization

1. In your Clerk Dashboard, navigate to Organizations(opens in a new tab) and select an organization.
2. Select the Members tab.
3. In the list of members, find the one whose role you want to change.
4. Select another role from their role dropdown.

Delete a role in your organization

You cannot delete a role that is still assigned to members of an organization. Change the members to a different role before completing the following steps.

1. In your Clerk Dashboard, navigate to Organization Settings(opens in a new tab) and select the Roles tab.
2. Select the "..." menu next to the role.
3. Select Delete role.

Last updated on February 12, 2024