> For the complete documentation index, see [llms.txt](https://docs.pandezlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pandezlabs.com/pandez-guard/premium/optional-roles.md).

# Optional roles

:white\_check\_mark:・Claimable optional roles built-in to the verification flow

:white\_check\_mark:・Set up claimable ping, age, language roles and more

:white\_check\_mark:・Send the optional roles panel to a specific channel for members to change their roles freely

{% hint style="success" %}
Buy premium: [buy.pandezlabs.com](https://buy.pandezlabs.com)
{% endhint %}

<figure><img src="/files/Sq9vSGLDkDk8lWfai4ZH" alt=""><figcaption></figcaption></figure>

#### Setting up roles

1. Use the `/config optional roles` command.
2. Click on the `Roles` button.
3. Click on `Add Role` and select a role from the dropdown menu. Roles with dangerous permissions, the verified role and the waiting room role, won't show up in the dropdown menu.
4. Select a category from the dropdown menu that best matches the role. This step will only appear if you have added at least one category.&#x20;
5. Add a description for your role or leave blank for no description, and click on `Submit`.

#### Setting up categories

1. Use the `/config optional roles` command.
2. Click on the `Categories` button.
3. Click on `Add Category`.
4. Click on `Single Choice` if you want members to only be able to select one role from this category. Click on `Multiple Choice` if you want members to be able to select multiple roles from this category.&#x20;
5. Add a name for the category, and click on `Submit`.&#x20;

#### Setting up the optional roles panel in a channel

1. Use the `/config optional roles` command.
2. Click on the `Channel` button.
3. &#x20;Select a channel from the dropdown menu. Only channels the bot has access to will show up. Make sure the bot has the `View Channel`, `Send Messages` and `Embed Links` permissions in the channel you want to send the panel too, as well as the `Manage Roles` permission on a role level.


---

# 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 dynamically by asking a question.

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

```
GET https://docs.pandezlabs.com/pandez-guard/premium/optional-roles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.