# Roles

Roles are resource objects to which Permissions are attached. Users assigned to a specific Role automatically inherit the permissions associated with that Role.

{% hint style="info" %}
Permissions inherited from a User's Role are limited by the User's Department.
{% endhint %}

<figure><img src="https://91127013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6B5cn0CbIbT4a4yvlffa%2Fuploads%2FsZ5xiXDquWY7mSuFW7pd%2FScreenshot%202024-06-10%20at%201.42.41%E2%80%AFPM.png?alt=media&#x26;token=d22e3d69-5fe2-4516-92da-10ccee9e8539" alt=""><figcaption><p>Roles Page</p></figcaption></figure>

## Viewing Roles

{% hint style="warning" %}
You must have permission to read Roles to perform the steps below.
{% endhint %}

1. Visit the Roles Page at <https://customdomain.com/admin/roles.&#x20>;
2. If you want to search for a particular Role (or a group of Roles) based on their attributes, click the "Filter" button in the upper-left corner.
3. Click the "View" icon in the row of your chosen Role.&#x20;

You will now see the Role's details, its list of Permissions, and the activities associated with that specific Role.

## Creating Roles

<figure><img src="https://91127013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6B5cn0CbIbT4a4yvlffa%2Fuploads%2FT1UKbCeoRWgbYtzF8msF%2FScreenshot%202024-06-10%20at%201.49.39%E2%80%AFPM.png?alt=media&#x26;token=91c875ec-2777-4106-b749-69137566c3b4" alt=""><figcaption><p>Create Role Page</p></figcaption></figure>

{% hint style="warning" %}
You must have permission to create Roles and be part of the Global Department to perform the steps below.
{% endhint %}

1. Visit the Create Role Page at <https://customdomain.com/admin/roles/create.&#x20>;
2. Fill out the name of the Role.
3. Select the Permission/s you wish to assign to the User.
4. Click "Create".

## Updating Roles

{% hint style="warning" %}
You must have permission to edit Roles to perform the steps below.
{% endhint %}

1. On the Roles Page, click the "Edit" icon in the row of your chosen Role. Alternatively, you can go to the Role's own page and click the "Edit" icon in the upper-right corner.

<figure><img src="https://91127013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6B5cn0CbIbT4a4yvlffa%2Fuploads%2FuZ6OjMzt8piJ7JHMl8fW%2FScreenshot%202024-06-10%20at%201.53.01%E2%80%AFPM.png?alt=media&#x26;token=cca709bc-885b-4026-ac66-b0d919af129e" alt=""><figcaption><p>Edit Role Icon on the Roles Page</p></figcaption></figure>

2. Update the settings you wish to change.&#x20;
3. Click "Save Edits".
4. Confirm the action on the dialog popup.

## Deleting Roles

{% hint style="warning" %}
You must have permission to delete Roles to perform the steps below.
{% endhint %}

1. On the Roles Page, click the "More" icon in the row of your chosen Role.

<figure><img src="https://91127013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6B5cn0CbIbT4a4yvlffa%2Fuploads%2FxGtAkcwXBUMUXC27Zpt6%2FScreenshot%202024-06-10%20at%201.55.20%E2%80%AFPM.png?alt=media&#x26;token=b970dbbe-c437-4ecd-a08e-da4c96f0618c" alt=""><figcaption><p>More Icon on the Roles Page</p></figcaption></figure>

2. Click "Delete Role".  Alternatively, you can go to the Role's own page and click the "Delete" icon in the upper-right corner.
3. Confirm the action on the dialog popup.

{% hint style="danger" %}
Deleting Roles is irreversible. Users associated with a deleted Role will immediately lose all permissions inherited from that role.
{% endhint %}