# Role Selection

Role selection allows your members to pick their own roles, helpful in multiple scenarios where you may want to for ping only members of a specific rol or gate specific channel access.

| Parameter    | Description                       |
| ------------ | --------------------------------- |
| Role         | A role to grant the members       |
| Display-name | The name you want the user to see |
|              |                                   |

#### Adding roles

To make roles available for users to select simply run: /role-selection add-role

Pick the role you want to add and the display name you want the user to see.

Example:

<figure><img src="/files/32vfwrr4zw6Thg0lM3XC" alt=""><figcaption><p>adding a new role</p></figcaption></figure>

After you run this command, you will get the following message each time you add a role, allowing you to decide when you are done and ready to make role selection available to your members.

<figure><img src="/files/YphXoqa2tba6XEcmxMH7" alt=""><figcaption><p>List of Roles added</p></figcaption></figure>

To create a dropdown available for your members to to pick their own roles, simply click on "Send Role Selection"

This message will be sent to the channel you are running the commands now available to everyone.

<figure><img src="/files/xG5agUEQD5f7XRlM8adq" alt=""><figcaption><p>Role selection result</p></figcaption></figure>

#### List roles  At any given moment you can check which roles you have entered in the system prior to making the dropdown available, simply run the following command:&#x20;

#### /role-selection list-roles

From here you can either confirm everything is as you wish and click 'Send Role Selection' or 'Delete a Role' to remove any unwanted option.

<figure><img src="/files/tbQ1fa5Wb6ecPEJFKtZe" alt=""><figcaption><p>List of Roles added</p></figcaption></figure>


---

# 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.tektools.app/product-guides/configuring-in-discord/role-selection.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.