Create Custom Roles

As a workspace administrator, you can create new roles and assign specific permissions to them in your workspace.

For Rocket.Chat workspaces on version 6.x.x and above, creating new roles and editing custom role permissions are exclusively accessible to workspaces subscribed to the Enterprise plan.

To create a new role,

• Go to Administration > Workspace > Permissions.

• Click on New role.

• A side panel opens. Provide the details required:

  • Role: Enter a name for the custom role.

  • Description: Set a description of the role.

  • Scope: Select the scope of the role. See Scope of Rocket.Chat roles for details.

  • Users must use Two Factor Authentication: Users assigned to this role are prompted for a 2FA code for certain activities. See the 2FA Configuration guide to learn how you can set up 2FA in your workspace. See the 2FA user guide to learn how to enable it for your account.

• Click Save.

To assign permissions to a role, select the corresponding permission checkbox under the role. To assign the custom role to a user, go to Administration > Workspace > Users. Select the user whose role you want to modify and update the Roles field.

• For more information, see the Roles and Permissions user guides.

• You can also create and manage roles and permissions using REST API endpoints. See the Roles API  and Permissions API for details.