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

# Custom Roles

{% hint style="info" %}
Available for users on **Plus**, **Pro**, and **Ultimate** subscriptions.
{% endhint %}

### Create a Custom Role

{% hint style="warning" %}
To create custom roles, the user must have **Create/Edit** permission for *Roles*.
{% endhint %}

1. In the left navigation panel, click **Admin**
   1. Select **Roles and Permissions** from the submenu. The **Roles** page is displayed.

      <figure><img src="/files/zZBSHY40w2LwyEGkUy8b" alt="" width="375"><figcaption></figcaption></figure>

      <sub>*UI under active update*</sub>
2. Click the **CREATE ROLE** button. The **Create Role** dialog will be displayed. The dialog contains a table with the list of permissions currently available in the system.
   1. Enter the role’s **Name** and **Description**, then check the **Permissions** you want to grant. Make sure to check the corresponding permissions listed in **MANDATORY DEPENDENCIES**.

      <figure><img src="/files/zsEwmCl4YZbcSmTJmMUQ" alt="" width="375"><figcaption></figcaption></figure>

      <sub>*UI under active update*</sub>
3. Click **SAVE**. The dialog will close, and the newly created role will appear on the **Roles** page.

### Edit a Custom Role

You can edit any **custom role**, including the default custom roles available in your organization.\
The **Owner** role is a system role and **cannot be edited.**

1. Go to **Admin → Roles and Permissions**. The **Roles** page is displayed.
2. On the **Roles** page, find the role you want to update. Click **Edit** in that role’s row.
3. Update the **name**, **description**, or **permissions** as needed.
4. Click **Save** to apply your changes.

### Delete a Custom Role

{% hint style="warning" %}
To delete a role, your account must include the **Delete** permission for **Roles**.

**Owner** role is a system role and **cannot be deleted**.
{% endhint %}

1. Go to **Admin → Roles and Permissions**. The **Roles** page is displayed.
2. On the **Roles** page, find the role you want to delete. Click **Delete** in the **Actions** column. After confirmation, the role will be permanently removed from the list.

{% hint style="info" %}
Deleting a role unassigns it from all users and **cannot be undone**.
{% endhint %}