> For the complete documentation index, see [llms.txt](https://help.solink.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.solink.com/docs/manage-users-locations-and-your-account/user-roles.md).

# User Roles

Define user permissions from the User Roles page.

User roles allow for a common set of feature permissions to be applied across multiple users in a scalable way.

A user role is a custom role that you create. It is not the same as the Standard or Admin user type.

For example, you might create a user role called "Manager", then assign only managers at your company to this "Manager" user role. You can then edit this user role so that all users assigned to the role can and cannot do certain things within Solink.

**Note:** Only Admin users can perform the actions described in this guide, such as creating, assigning, or removing user roles. Standard users have limited access and should contact an Admin for assistance.

From the **User Roles** page you can:

* [Create User Roles](#create-user-roles)
* [Assign Users to a Role](#assign-users-to-a-role)
* [Remove Users from a Role](#remove-users-from-a-role)
* [Delete a User Role](#delete-a-user-role)
* [Duplicate a User Role](#duplicate-a-user-role)

User roles are located in Solink **Settings**:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-f1d11998446a1ad4acda57cd3009f77e07e4c8ac%2Fb5dbb365beea9aa0.png?alt=media)

**Note:** For comprehensive user management, including advanced permission settings, use the Solink website rather than the app.

### Create User Roles

You can create a user role for a certain group of individuals in your company or business and ensure only those assigned the role have certain Solink permissions.

To create a user role:

1. From the **User Roles** page in **Settings**, select the **Add** button.
2. Give the role a name and description that will help others understand the purpose of this role.
3. Select **Save** to move to the next step.
4. Scroll down to begin assigning user permission to this role.
5. Select one of the following options to assign or disable a user permission for the user role:

   * **On**: This enables the feature for the user.
   * **Off**: This disables the feature for the user.

   **Note:** Select or leave the **Default** option enabled if you wish to keep the state indicated next to Default. This Default state can be changed by an administrator at any time.
6. Select **Save** at the bottom of the permissions list to apply the changes.

Next, you need to assign users to this role. See the next section to understand how to assign users to a role.

### Assign Users to a Role

Select the **Users** tab (located above the permissions list) to begin assigning users to this role:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-95479c17655b65a498862b392a27b18f7e1ccb13%2F237eb035b5121fce.png?alt=media" alt="" width="560">

To assign users to the role:

1. Select the **Add** button:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-f456ad08a4d058dc32dd5dcc8d349d463cba41b7%2F2a5cf1a7916e0b93.png?alt=media" alt="" width="560">

2. A list of all users in the account is displayed. Select individual users by selecting the "checkbox" located next to the user's name. Each of the users you select will be assigned to the user role:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-e764b732e22bb2bcb9780920c21a16638d1b2510%2F8bf8b8f0ce953026.png?alt=media" alt="" width="560">

3. Select **Save** to assign the selected users to the role.

**Tip:** Select the "checkbox" at the top of the list to select all users on the page at once.

**Note:** You can assign up to **10** users to a role at once. You must repeat the process in this section to add 10 users at a time (add users to the role via the checkboxes, select **Save**, repeat).

### Remove Users from a Role

You can remove an individual user from a role, or several users from the role at once.

To remove users assigned to a role:

1. From the **User Roles** page in **Settings**, select **Edit** next to the user role:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-013428b2c8cef3f1b90b4695a6912416a5de0229%2F388525aacade8bae.png?alt=media" alt="" width="640">

2. Select the **Users** tab:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-95479c17655b65a498862b392a27b18f7e1ccb13%2F237eb035b5121fce.png?alt=media" alt="" width="560">

3. Remove one user or several users at once:
   * To remove one user, select the **Remove** button next to the user:

     <img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-422f48332c7816f084a5f13eb7ca70c3310f25fa%2F9edf4d9aba6fe348.png?alt=media" alt="" width="560">
   * To remove users in bulk, select the "checkboxes" beside each user you want to remove, then select **Remove** located near the top of the page. A confirmation appears asking if you are sure you want to remove these users. Select **Confirm** to remove the users from the role:

     <img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-22a62cdafd06f2919f9426aff95844e5600aa390%2Fd2921c0f06d69281.png?alt=media" alt="" width="560">

### Delete a User Role

To delete a user role, find the role from the **User Roles** page and select the **Delete** button:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-e6e888ed72008acd3207385a1eedb4eb50fb4172%2F098d5194c33b0828.png?alt=media" alt="" width="640">

Select **Confirm** when prompted to fully delete the user role.

**Note:** Roles can be deleted in bulk using the checkboxes on the left side of each role name.

### Duplicate a User Role

You can duplicate a user role in the event that you wish to create a copy of a user role with all users and permissions intact.

To duplicate a user role, find the role from the **User Roles** page and select the **Duplicate** button:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-d66fac6759e08aa5ecfc845b139a279a252c13d3%2F140afb3e0428c733.png?alt=media" alt="" width="640">

From here you can rename the role and give it a new description, then select **Save** to create the duplicate user role.

### Notes on User Roles

Please take note of the following regarding user roles:

* Currently, a user can only be assigned to one role at a time. This means you cannot assign one user to multiple different roles.
* There is currently no way for admin users to view or modify the permissions of other admin users in the **Users** tab in Solink **Settings**.
* Solink does not provide a feature to identify who made changes to user permissions.
* In some organizations, user profiles may be managed internally and not directly through Solink. If this applies to your organization, contact your internal administrator for assistance.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.solink.com/docs/manage-users-locations-and-your-account/user-roles.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
