> ## Documentation Index
> Fetch the complete documentation index at: https://docs.utopikai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Roles

> Create roles and assign permissions to users and groups

> [!NOTE]
>
> **Roles** is only available for **Workspace Admin**.

**Roles** define the permissions people and groups have in the workspace. Open **Admin** → **User Management** → **Roles**.

![Roles page in Workspace Admin](https://mintcdn.com/utopikai/wjuuT4EwTFZDwCVu/images/user_management/Roles.png?fit=max\&auto=format\&n=wjuuT4EwTFZDwCVu\&q=85\&s=429605f72abecdd96b58d926f7dd102c)

## What you can do

| Control | What it does |
| - | - |
| **Search roles** | Find a role by name |
| **Default Status** | Filter by whether a role is a default role (for example **All**) |
| **Create role** | Add a role and choose its permissions |

## Roles table

| Column | What it shows |
| - | - |
| **Role** | Role name |
| **Description** | What the role is for |
| **In use** | How many users have the role, and how many permissions it includes |
| **Default** | Whether the role is assigned by default (**Yes** or **No**) |
| **Actions** | Row menu for further options |

The footer shows the total number of rows and the rows-per-page setting.

Create a role when you need a specific set of permissions, then assign it to users or [groups](https://docs.utopikai.com/user_management/groups.md).

## Create a role

Click **Create role**. The flow has three steps: **Role details**, **Permissions**, and **Summary**.

### 1. Role details

Enter the role name and an optional description, then **Continue**.

![Create role — Role details](https://mintcdn.com/utopikai/wjuuT4EwTFZDwCVu/images/user_management/CreateRoleDetails.png?fit=max\&auto=format\&n=wjuuT4EwTFZDwCVu\&q=85\&s=f959d05a0525c79bb90773ada7284c17)

| Field | Required | What it does |
| - | - | - |
| **Name** | Yes | Name shown in the roles list and when assigning access |
| **Description** | No | Short summary of what the role can do |

Click **Cancel** to close without creating a role.

### 2. Permissions

Choose an entity on the left, then select the permissions that entity should allow. Use **Search entities** and **Search permissions** to find a specific item.

![Create role — Permissions](https://mintcdn.com/utopikai/wjuuT4EwTFZDwCVu/images/user_management/CreateRolePermissions.png?fit=max\&auto=format\&n=wjuuT4EwTFZDwCVu\&q=85\&s=cbfae594cc6143babd81742daa3bdbab)

| Control | What it does |
| - | - |
| **Entities** | Resource types you can grant access to, with how many permissions are selected |
| **Select all** / **Clear all** | Select or clear every permission for the current entity |
| **Search permissions** | Filter the permission list for the selected entity |

Each permission has a name (for example `activity:create`) and a short description. Deprecated permissions appear in audit history but cannot be assigned to new roles.

### 3. Summary

Review the role details and selected permissions, then **Save permissions**. Permissions apply after the role is saved.

![Create role — Summary](https://mintcdn.com/utopikai/wjuuT4EwTFZDwCVu/images/user_management/CreateRoleSummary.png?fit=max\&auto=format\&n=wjuuT4EwTFZDwCVu\&q=85\&s=020a53c698a89269b65f7ac1023350b3)

The summary shows:

* **Role details** — name and description
* **Permissions** — the permissions you selected, with a count

Use **Back** to change the name, description, or permissions. After you save, the role appears in the roles list and can be assigned to users or groups.

## Related documentation

* [User Management Overview](https://docs.utopikai.com/user_management/overview.md)
* [Users](https://docs.utopikai.com/user_management/users.md)
* [Groups](https://docs.utopikai.com/user_management/groups.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.