> For the complete documentation index, see [llms.txt](https://docs.simplifyqa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.simplifyqa.ai/admin-controls-and-configurations/manage-projects-and-users/project-settings/manage-roles-and-privileges.md).

# Manage Roles and Privileges

Roles and privileges are fundamental concepts used to manage user access and permissions.

* **Roles:** A role is a collection of privileges assigned to a group of users. It defines the set of actions that users in a particular role are authorised to perform.
* **Privileges:** Privileges are specific permissions granted to users, allowing them to access certain resources or perform certain actions within the system.

This document provides step-by-step instructions on how to configure privileges for different roles and assign these roles to specific users within your project.

### Configuring Privileges

* **Navigate to Project Settings:** Go to **Admin** > **Projects** > **\[Project Name]** > **Project Settings**.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2Fpkw58gmUvrX8Kuw8xvLF%2Fimage.png?alt=media&amp;token=99e62d98-4e0f-41f5-a2e1-aec062f7c4e5" alt=""><figcaption></figcaption></figure>

* **Access Roles & Privileges:**&#x20;
* Click on the **Roles & Privileges** tab.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FhSS1dW0cjjhb3vk9Z91p%2Fimage.png?alt=media&amp;token=782d8200-8abf-4be5-9d2d-7508d40db660" alt=""><figcaption></figcaption></figure>

* **Select a Role:** Click on the desired role to view and edit its privileges.
* **Manage Privileges:**
  * **Action:** Click on the toggle switch next to each privilege to enable or disable it.
  * **Permission:** The status of the permission will be indicated by a green dot (enabled) or a grey dot (disabled).

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FbpyWF5hDZAfDb1fKiG8u%2Fimage.png?alt=media&amp;token=51d3816c-d6f4-4a77-b0fb-88fb55986c37" alt=""><figcaption></figcaption></figure>

* **Set as Default:** Select the 'Set as default' to make this role the default role.&#x20;
  * When a new user is invited to SimplifyQA or to a new project, the default role would be assigned to the user.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FFH6OVQANC4xVDpkN5M6m%2Fimage.png?alt=media&amp;token=63f0efee-3843-4715-8575-0da9166edae9" alt=""><figcaption></figcaption></figure>

* **Save Changes:** Click on the **Save** button to apply the changes.

### Adding a New Role

* **Navigate to Project Settings:** Go to **Admin** > **Projects** > **\[Project Name]** > **Project Settings**. Click on the **Roles & Privileges** tab.
* **Add New Role:** Click on the '**+ Role'** button.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FKBKguV7XLcCnLllwUHlf%2Fimage.png?alt=media&amp;token=96c39eab-42e0-48de-9db1-e7307206824f" alt=""><figcaption></figcaption></figure>

* **Enter Role Name and Description:** Provide a clear and concise name for the new role. Add a brief description to explain the purpose of the role.
* **Assign Privileges:** Select the appropriate privileges from the list and assign them to the new role.
* **Save Changes:** Click on the **Save** button to create the new role.

{% hint style="info" %}
**Best Practices**

* **Least Privilege Principle:** Assign roles with the minimum necessary privileges to each user.
* **Regular Review:** Regularly review and update role assignments and privileges to maintain security and control.
* **Clear Documentation:** Maintain clear documentation outlining the responsibilities and privileges associated with each role in the description.
  {% endhint %}
