---
title: "Manage Roles"
slug: "manage-roles"
description: "How to create and manage roles outside of Reveal’s defaults, and how to and assign users to roles."
tags: ["add role", "Create Role", "delete role", "edit role"]
updated: 2026-02-17T21:44:07Z
published: 2026-02-17T21:44:07Z
canonical: "docs.revealdata.com/manage-roles"
---

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

# Manage Roles

**Roles** allow you to enable or disable specific permissions that can be exercised in a project, and also limit access to unauthorized areas in the Reveal environment. For information about how roles function in Reveal, and for a list of Reveal’s default roles, see [About Permissions](/reveal/docs/about-permissions#roles-and-role-groups).

Roles are created and managed in the Roles page by navigating to **Project Admin** > **Teams + Roles** > **Roles** from the project navigation sidebar.

![Overview of user roles and permissions in the Project Admin interface.](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Project-Admin-Roles_2025.10.png)

## Create roles

Outside of Reveal’s default roles, you can create your own roles to further customize specific permissions for your users.

From the Roles page:

1. Click ![Add icon](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Plus_Icon.png)**Add**.
2. In the **Add Role** modal:

![Interface for adding a role with fields for name and description.](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Add-Role-Modal_2025.12.png)
  1. **Name**: Name your role.
  2. **Description**: Add a description of your role.
3. Click **ADD** to create your role.

> [!NOTE]
> **Note**
> 
> Each role must be mapped to its own unique role group. See [Manage Role Groups](/reveal/docs/manage-role-groups) for further instructions.

### Assigning permissions

A new role, by default, will have no permissions and need them assigned manually. See [Assign Permissions](/reveal/docs/assign-permissions#modify-permissions) for instructions on giving a new role permissions.

## Managing roles

Role management is performed in the the Roles page. Here, you can:

- ### Edit roles
- ### Delete roles

**Edit roles**

### Edit roles

Editing a role allows you to change its name or description. If you would like to change which permissions are assigned to a role, follow the instructions in our [Assign Permissions](/reveal/docs/assign-permissions#modify-permissions) article.

1. Click your role from the list. Its row will highlight in blue.
2. Click ![Edit icon](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Pencil-Edit_Icon(1).png) **Edit**.
3. In the Edit User modal, edit the fields as needed. See the [Create roles](/reveal/docs/manage-roles#create-roles) section for a description of each field.
4. Click **EDIT** to save your changes.

**Delete roles**

### Delete roles

1. Click your role from the list. Its row will highlight in blue.
2. Click ![Delete icon](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Trash_Icon2(1).png) **Delete**.
3. A confirmation modal will appear. Click **OK** to delete the role.

> [!NOTE]
> **Note**
> 
> You cannot delete a role if it’s currently mapped to a role group.

## Related

- [About Permissions](/about-permissions.md)
- [Manage Users – Web](/manage-users-web.md)
- [Manage Users – Review Manager](/manage-users-review-manager.md)
- [Assign Permissions](/assign-permissions.md)
- [Permissions Matrix (Default)](/permissions-matrix-default.md)
- [Manage Role Groups](/manage-role-groups.md)
- [Manage Teams](/manage-teams.md)