> ## 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.

# VCRoles

> Automatically assign roles to members connected to voice channels.

# Voice Channel Roles

Voice Channel Roles automatically assign roles to members while they are connected to a voice channel.

When a member leaves all voice channels, the role is automatically removed.

This feature is useful for:

* Identifying active voice participants
* Rewarding voice activity
* Showing who is currently in voice channels
* Granting temporary voice-only permissions

## Human VCRoles

Human VCRoles are assigned to regular members.

### Add a Human VCRole

```bash theme={null}
?vcrole humans add <role>
```

Example:

```bash theme={null}
?vcrole humans add @In Voice
```

### Remove a Human VCRole

```bash theme={null}
?vcrole humans remove <role>
```

## Bot VCRoles

Bot VCRoles are assigned to bot accounts when they join a voice channel.

### Add a Bot VCRole

```bash theme={null}
?vcrole bots add <role>
```

### Remove a Bot VCRole

```bash theme={null}
?vcrole bots remove <role>
```

<Info>
  Bot VCRoles are a Prime feature.
</Info>

## View Configuration

```bash theme={null}
?vcrole show
```

Displays all configured Human and Bot VCRoles.

## Reset VCRoles

```bash theme={null}
?vcrole reset
```

Removes all configured VCRoles.

<Warning>
  Resetting VCRoles only removes the configuration. Existing Discord roles are not deleted.
</Warning>

## Limits

Free servers can configure 1 Human VCRole.

Prime servers can configure up to 5 Human VCRoles and 5 Bot VCRoles.

## Important Notes

* BlaZe's highest role must be above the VCRoles it manages.
* Server owners bypass role hierarchy restrictions.
* Roles are automatically given when joining a voice channel.
* Roles are automatically removed when leaving voice channels.