# User & Role Management

## Introduction

User & Role Management functionality enables administrators to create roles with specific user permissions such as read, write, and delete. Users assigned these roles can perform the functions defined by their permissions. This feature allows organizations to manage access control effectively by creating roles for different positions within the organization.

## Process

Click the Toggle icon on the **Home Screen** above the **Projects** tab and navigate to the **Administration** Tab.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FcBxB42Hc37Wv88HIyuxN%2Fimage.png?alt=media&#x26;token=ada97645-80a8-4b2e-a910-63fc6c17eaf0" alt=""><figcaption></figcaption></figure>

## Create Permissions

1. Click on the **New** icon next to the **Permissions** list.
2. Provide a desired name for the **New Role Permission** and click **Create**.
3. Enable various operative permissions that you would like for this specific role (e.g., **Marketing Lead**).

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FFnQlTQN5LorEl08vmLME%2Fimage.png?alt=media&#x26;token=58fefb4b-fc13-4028-847e-891acd74c469" alt=""><figcaption></figcaption></figure>

## Creating Users

1. Ensure you have a role created that you would like to assign to the user.
2. Click on the **Users** tab and click **Add User**.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FLd5fQwjJaO3tSXAOY0mR%2Fimage.png?alt=media&#x26;token=2f79a8f9-c0ab-4b18-a227-723bba3f8e26" alt=""><figcaption></figcaption></figure>

3. Define a username, password, first name, last name, and the desired role for this user. Click the dropdown to access various roles created in your organization.
4. Click **Save Changes**.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2F7I90maFIGMlNMGmwEoii%2Fimage.png?alt=media&#x26;token=16b3b869-f585-4dda-a81f-5945dde3f31e" alt=""><figcaption></figcaption></figure>

### Manage Users

Once you create a new user, you can choose to manage the user.

1. Upon creation of a new user, you will be redirected to a page displaying various users within your organization.
2. You can edit or delete the user at any time from this list by clicking the **Bin** or **Pencil** icon next to the username.

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FepQ6xtm0o5e6uNeIAqZG%2Fimage.png?alt=media&#x26;token=12666be7-bb74-49a8-a4db-5a6e8da664d6" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**PRO TIP**

Regularly review and update roles and permissions to ensure they align with the evolving responsibilities and access requirements of your users.
{% endhint %}

## Features and Benefits

* **Controlled Access:** Enable permissions for specific users and provide them access to perform various operations within the application such as read, write, and run.
* **Easy Business Operations:** Create users for various departments such as sales lead, account head, operations manager, etc.
* **Enhanced Security:** Admin functionality that enhances the security of the application's data.
* **Single Pane View:** Provides a single view of the various users, their permissions, and access to data.

<details>

<summary>Frequently Asked Questions (FAQ)</summary>

1. Can I create roles with multiple permissions?

Yes, you can create roles with a combination of permissions such as read, write, and delete to fit the specific needs of different positions.

2. How do I modify an existing role?

Navigate to the role management section, select the role you wish to modify, and click the 'Edit' icon. You can then update the permissions and save the changes.

3. Can I assign multiple roles to a single user?

No, a user can be assigned only one role at a time. Ensure the role encompasses all necessary permissions required by the user.

4. What happens if I delete a role that is currently assigned to a user?

If a role is deleted, the users assigned to that role will lose the permissions associated with it. It's recommended to reassign users to a different role before deleting any role.

</details>
