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

# Overview

> Learn how Custom Roles work.

# Custom Roles

Custom Roles allow server administrators to create their own role commands.

Once configured, a custom role can be given or removed simply by using its assigned command.

For example, a custom role named:

```txt theme={null}
vip
```

can be used as:

```txt theme={null}
?vip @User
```

If the user does not have the role, BlaZe will assign it.

If the user already has the role, BlaZe will remove it.

This makes Custom Roles useful for:

* Staff permissions
* Event roles
* Game roles
* Temporary access systems
* Community management

## How It Works

Every custom role consists of:

* A command name
* A Discord role
* Optional manager roles

When the command is used, BlaZe automatically toggles the configured role for the target member.

<Info>
  Custom role commands cannot contain spaces and must be unique.
</Info>

## Custom Role Managers

Custom Role Managers are roles that can use custom role commands without requiring Manage Server permissions.

This allows server owners to delegate role management without granting full administrative permissions.

<Warning>
  Custom Role Managers can grant and remove all configured custom roles.
</Warning>