# Managing User Roles

## Managing Roles

The Aisera Platform offers several built-in roles, but you can also create and manage custom permissions to suit your specific needs.

{% hint style="warning" %}
When you create roles and permissions, it is a best practice to document the reasons with examples of each role and permission you created. Although you can see the permissions in the UI, it may be difficult for you to determine where a specific restriction is coming from.
{% endhint %}

### Creating a Custom Role

1. Open **Settings > User Accounts** from the left navigation menu
2. Select the **Roles** tab at the top of the **User Accounts** window

   <div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FvxLgSvXcBSjuAqNhHtmQ%2Fimage.png?alt=media&#x26;token=43b5bb44-e1b9-4fa6-8c73-e0066fff4134" alt=""><figcaption></figcaption></figure></div>
3. Choose **+ Create Role**<br>

   <div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FaizcCdqifmfLlTzln52o%2Fimage.png?alt=media&#x26;token=4832f86c-fadb-4939-b47c-f00f809b7603" alt=""><figcaption></figcaption></figure></div>
4. Enter a **Name** and **Description** for the role.&#x20;
5. &#x20;Select an appropriate level of privilege

   <div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2Fcx2nVHdDKtysiSMxuowx%2Fimage.png?alt=media&#x26;token=d834d45f-0115-4cb5-8594-47e7f58c215c" alt=""><figcaption></figcaption></figure></div>

### Editing a Custom Role

{% hint style="info" %}
System and default roles are not editable. You can only modify custom roles.
{% endhint %}

1. Open **Settings > User Accounts** from the left navigation menu
2. Select the **Roles** tab at the top of the **User Accounts** window
3. Select the role you want to modify
4. Click on the **pencil icon** in the top right to see the **Edit Role** window<br>

   <div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2Fx2mwnSrG5hbbxIF7mQgQ%2FRoleDetailsPage-EditButtonHighlighted.png?alt=media&#x26;token=9a0c3aa2-53fb-4ed0-8af3-90b9adf209c5" alt=""><figcaption></figcaption></figure></div>
5. Change the **Name**, **Description** or **Privileges** for the role
6. Click **Ok** to save changes

### Deleting a Custom Role

{% hint style="info" %}
System and default roles cannot be deleted. Only custom roles can be removed.
{% endhint %}

1. Open **Settings > User Accounts** from the left navigation menu
2. Select the **Roles** tab at the top of the **User Accounts** window
3. Select the role you want to delete
4. Click on the **trash icon** in the top right to see the **Delete Role** window<br>

   <div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FUv59Lt3xbo9fNSKp8ZS7%2FDeleteRoleWindow.png?alt=media&#x26;token=8b7922e1-bee4-4b1f-a41b-2451e4a53898" alt=""><figcaption></figcaption></figure></div>
5. Click **Ok** to confirm deletion of the role

**Assign Application Access for PII by Role**

You can give member of a custom role access to Personal Identifiable Information (PII), by choosing the **piis** checkbox for your new role.

<div align="left"><figure><img src="https://docs.aisera.com/~gitbook/image?url=https%3A%2F%2F2983236984-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FiZkLJr3EjXkd2tHYiQJP%252Fuploads%252FANMpscRlZ8WA4lJv7VTZ%252Funknown.png%3Falt%3Dmedia%26token%3Deb9d3960-1461-4715-8afd-9c32a76f3e33&#x26;width=300&#x26;dpr=4&#x26;quality=100&#x26;sign=1c1f3a88&#x26;sv=2" alt="" width="563"><figcaption></figcaption></figure></div>
