> ## Documentation Index
> Fetch the complete documentation index at: https://docs.razebot.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Roles

> Configure server custom roles with named presets and role requirements.

# Custom Roles System

<Badge variant="pro">Tier 2: Pro</Badge>

> Manage named custom role templates, allow members with required roles to claim custom roles, and easily organize special server privileges.

***

## Command Overview

| Command       | Aliases | Syntax                                 | Description                                  | Permissions |
| :------------ | :------ | :------------------------------------- | :------------------------------------------- | :---------- |
| `.customrole` | `setup` | `.customrole <subcommand> [arguments]` | Manage server custom roles and requirements. | ManageRoles |

***

## Subcommands Reference

| Subcommand | Syntax                                             | Description                                            | Example                          |
| :--------- | :------------------------------------------------- | :----------------------------------------------------- | :------------------------------- |
| `add`      | `.customrole add <name> <@role\|roleId\|roleName>` | Adds a new named custom role                           | `.customrole add vip @VIP`       |
| `remove`   | `.customrole remove <name>`                        | Removes a named custom role                            | `.customrole remove vip`         |
| `reqrole`  | `.customrole reqrole <@role\|roleId\|roleName>`    | Sets required prerequisite role to access custom roles | `.customrole reqrole @Supporter` |
| `list`     | `.customrole list`                                 | Lists all configured custom roles                      | `.customrole list`               |
| `config`   | `.customrole config`                               | Displays current custom role configuration             | `.customrole config`             |
| `reset`    | `.customrole reset`                                | Resets all custom role settings                        | `.customrole reset`              |

***

## Configuration Examples

<Tabs>
  <Tab title="Add Custom Roles">
    ```bash theme={null} theme={null}
    .customrole add vip @VIP
    .customrole add elite @EliteMembers
    ```
  </Tab>

  <Tab title="Set Role Gate">
    ```bash theme={null} theme={null}
    .customrole reqrole @Donator
    ```
  </Tab>

  <Tab title="View & Manage">
    ```bash theme={null} theme={null}
    .customrole list
    .customrole config
    .customrole remove vip
    ```
  </Tab>
</Tabs>