> For the complete documentation index, see [llms.txt](https://securitybot.gitbook.io/securitybot-knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://securitybot.gitbook.io/securitybot-knowledge-hub/command-reference/roles.md).

# /roles

{% hint style="success" %}
**Available on all tiers**
{% endhint %}

Configure which Discord roles map to SecurityBot's Administrator, Moderator, and Exempt permission tiers. Use `/roles view` to see the current configuration, or assign roles with the other subcommands.

The exempt list supports multiple roles. Add or remove roles individually with `/roles exempt add` and `/roles exempt remove`, or manage the full list from the web dashboard.

***

## Usage

| Subcommand      | Options                 | Description                                                |
| --------------- | ----------------------- | ---------------------------------------------------------- |
| `view`          | None                    | Shows current role configuration (admin, mod, exempt list) |
| `administrator` | `role` (Role, required) | Sets the SecurityBot administrator role                    |
| `moderator`     | `role` (Role, required) | Sets the SecurityBot moderator role                        |
| `exempt add`    | `role` (Role, required) | Adds a role to the exempt list (bypasses filters)          |
| `exempt remove` | `role` (Role, required) | Removes a role from the exempt list                        |

### Example

```
/roles administrator role: @Staff
```

```
/roles exempt add role: @Mods
/roles exempt add role: @Partners
/roles view
```

```
/roles exempt remove role: @Partners
```

***

## Validation

* You cannot **assign** managed roles (bot roles or integration roles) to administrator, moderator, or the exempt list.
* For `administrator` and `moderator`, the bot must be higher in the role hierarchy than the role being assigned. The exempt list has no hierarchy requirement -- you can exempt roles above the bot.

***

## Permissions

**Administrator** -- All subcommands require the SecurityBot admin role, Discord ADMINISTRATOR permission, or server ownership.