> For the complete documentation index, see [llms.txt](https://docs.unitlab.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unitlab.ai/documentation/collaboration/permissions-and-custom-roles.md).

# Permissions and custom roles

Every workspace permission explained, and how to build a custom role.

A custom role is a named set of permissions. Use one when no built-in role fits, for example a QA lead who can assign tasks and see team statistics but not manage members. You need the **Manage workspace settings** permission.

## Create a custom role

1. Open **Settings > Roles & Permissions** and select **Create role**.
2. Enter a name and a short description.
3. Turn on the permissions the role needs. A new role starts with the Member permissions.
4. Assign the role to members in **Settings > Members**.

Use **Search roles or permissions...** to find a permission quickly. Delete a custom role from its menu with **Delete role**.

## Permissions

### Workspace

| Permission                    | Allows                                                                                              |
| ----------------------------- | --------------------------------------------------------------------------------------------------- |
| **Manage workspace settings** | General settings, roles, connected assistants for others, and the audit log. Owner only by default. |
| **Manage billing**            | Billing & Usage: plan, seats and invoices.                                                          |
| **Manage API keys**           | Create and manage API keys.                                                                         |
| **Manage cloud storage**      | Connect and edit cloud buckets.                                                                     |
| **Manage members**            | Invite, change roles, deactivate and remove members. Also shows cost in statistics.                 |

### Projects

| Permission              | Allows                                                     |
| ----------------------- | ---------------------------------------------------------- |
| **Manage projects**     | Create, rename and configure projects.                     |
| **Manage classes**      | Add and edit ontology classes.                             |
| **Manage tasks**        | Assign, release, prioritize and move tasks between stages. |
| **Manage releases**     | Create and manage releases.                                |
| **View ontology**       | See the project's classes.                                 |
| **View instructions**   | Read the project instructions.                             |
| **Manage instructions** | Edit the instructions and upload the guide file.           |

### Annotation & Review

| Permission                  | Allows                                                                                                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **View labeling interface** | Open items in the editor.                                                                                                                                                             |
| **Create labels**           | Save labels and submit tasks.                                                                                                                                                         |
| **Comment**                 | Write comments and issues.                                                                                                                                                            |
| **View statistics**         | See their own statistics.                                                                                                                                                             |
| **View team statistics**    | See workspace and project statistics for everyone.                                                                                                                                    |
| **Two-step edit mode**      | Objects must be selected with **Edit** before they can be changed, which prevents accidental edits. On for every role by default. Turning it off lets the role edit objects directly. |

### Models & Data

| Permission              | Allows                                                  |
| ----------------------- | ------------------------------------------------------- |
| **Manage data**         | Upload, import, archive and organize data and datasets. |
| **Manage AI models**    | Add and configure models.                               |
| **Manage workflows**    | Edit project workflows.                                 |
| **Manage augmentation** | Run data augmentation on releases.                      |

{% hint style="info" %}
Permission names in your workspace can differ slightly from this list. The description under each switch on the page says what it allows.
{% endhint %}

## Related

[Role-based access](https://docs.unitlab.ai/documentation/collaboration/role-based-access.md) · [API keys and service identities](https://docs.unitlab.ai/documentation/security/api-keys-and-service-identities.md)
