# Manage Roles

## User Guide: Admin Tab <a href="#user-guide-admin-tab" id="user-guide-admin-tab"></a>

### Manage Roles <a href="#manage-roles" id="manage-roles"></a>

An administrative user with permission to manage roles (for example, a user with the [predefined](/bluefletch-enterprise/product-guides/portal/admin/roles/predefined-roles.md) "Admin" role) can create, edit, and delete custom roles or assign a role to one or more users from the [***Roles***](https://ems.bluefletch.com/admin/roles) subtab within the ***Admin*** section of the BlueFletch Portal.

<figure><img src="/files/w73150BvRCpE2VTjsXZf" alt="" width="563"><figcaption></figcaption></figure>

#### Create Roles <a href="#create-roles" id="create-roles"></a>

1. On the ***Roles*** page, press the **Create New Role** button in the upper right corner.
2. Enter content in the *Role Name* and *Description* fields. These fields are required.

<figure><img src="/files/ZhDh97fYfSjnmZEL7tC4" alt="" width="563"><figcaption></figcaption></figure>

3. Press **Select Permissions** button and check at least one permission from the list. A permission must be selected to create a role.\
   Consult the [***Permissions***](/bluefletch-enterprise/product-guides/portal/admin/roles/permissions.md) document to determine if there are any prequisites for a permission; an error will occur on login for a user who is assigned a role that is missing permissions.
4. Press **Select Users** button and select one or more users, if desired. Selecting a user is not required to create a role.

   > **Note:** A role can also be applied to a user when adding or editing one in the [***Users***](https://ems.bluefletch.com/admin/users) subtab within ***Admin***.
5. Press **Create** button to save the new role. The role will appear in the alphabetized list on the ***Roles*** page.

#### Edit and Delete Roles <a href="#edit-and-delete-roles" id="edit-and-delete-roles"></a>

1. On the ***Roles*** page, select a role from the list on the left and select **Edit Role** or **Delete Role** from the three-dot option menu.
2. If choosing to delete, an alert box will display prompting confirmation. Only roles created by the organization may be deleted. Predefined roles cannot be deleted.

<figure><img src="/files/pTQ2a5Pk9S9stFD5ylBg" alt="" width="563"><figcaption></figcaption></figure>

3. If choosing to edit, the screen will proceed to ***Edit Role*** page. Make any changes (as allowed, depending on the role) to the role and press **Update** button to save changes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/roles/manage-roles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.