---
title: Add roles & permissions
slug: add-roles-and-permissions
docTags: 
createdAt: 2024-04-12T00:37:55.165Z
---

:::hint{type="info"}
**Who can do this:**

- Anyone with the Roles (editable) permission
:::

Assigning roles is an essential aspect of managing access and security within the dashboard. You can opt to use existing roles that are ready for you to use, or create your own.

# View admin roles

Before adding a new role, check if it already exists. 

To view existing admin roles:

1\. Go to **Admin** ➤ **Admin roles, **and in the top-left corner, tick **Show inherited**.

- All roles created above your admin level are displayed, in addition to any created at your level.  

![](https://api.archbee.com/api/optimize/UvIid87QOyOAFNtwAJwuq/mafPY852BnLia1rvEvDfd_group-140-2.png)

2\. In the list, select a role to view or edit it. 

:::hint{type="success"}
**Why are some roles read-only?** 

Roles are read-only if they haven't been made available to the group or team you're an admin for, and if you haven't been given a role with role editing privileges.<font color="#ff6900"> </font>
:::

# Add or edit roles

Create roles that align with each of your administrator's responsibilities.&#x20;

:::hint{type="warning"}
**How do** **I ensure a role has the correct permissions?**

To ensure you have the permissions you need, please let Refresh’s Customer Success team know what additional roles you'd like.
:::

To add a role:

1\. Go to **Admin** ➤ **Admin roles,&#x20;**&#x20;and click **Add**.

- A **New Role** window opens.

![](https://api.archbee.com/api/optimize/UvIid87QOyOAFNtwAJwuq/3Iwg3tlOBZeSCoabcM7EH_screenshot-2024-04-26-at-1152.png)

2\. On the left, enter the name and description you want.

3\. Tick each permission you want to give the role.&#x20;

- Once selected, permissions appear on the right. By default, **Visible** is selected.&#x20;

4\. Tick **Editable** next to each permission, as needed.&#x20;

5\. Under **Admin availability,&#x20;**&#x73;elect the Group(s) for which admins you want to give permission to edit the role.

:::hint{type="success"}
**How does admin availability work?&#x20;**

Only the admins for the Organization/Groups/Teams you select in the Admin availability section can be granted the Roles permission to edit the role.
:::

6\. Click **Save**.

Now you're ready to assign roles to users.&#x20;