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

# VC Role

> Automatically assign a role to members when they join a voice channel.

The VC Role system lets you automatically assign a specific role to members as soon as they connect to any voice channel in your server. When they leave the voice channel, the role is instantly removed. This is perfect for creating "In Voice" lists or giving members access to voice-chat-only text channels while they are connected.

<Note>
  **Required Permission:** [Hierarchy Status](/permissions/hierarchy) — Server Owner, Extra Owner, or a user with a role higher than the bot's highest role.
</Note>

***

## Setting Up

Configuring the VC Role system is quick and easy.

<Steps>
  <Step title="Run the Set Command">
    Provide the role you want to award to members who join voice channels.

    ```bash theme={null}
    .vcrole set @In Voice
    ```
  </Step>

  <Step title="Verify the Configuration">
    Use the show command to confirm your role is set and the system is enabled.

    ```bash theme={null}
    .vcrole show
    ```
  </Step>
</Steps>

<Warning>
  For security, ZEON blocks you from assigning roles that have dangerous permissions (Administrator, Manage Server, etc.). The bot will also refuse to manage a role that is equal to or higher than its own top role, or yours.
</Warning>

***

## Commands

All commands are located under the `.vcrole` (or `.voicerole`) group.

| Command              | Description                                                                  |
| :------------------- | :--------------------------------------------------------------------------- |
| `.vcrole set <role>` | Sets the role to be automatically given to users who join any voice channel. |
| `.vcrole show`       | Shows the currently configured VC role and whether the system is enabled.    |
| `.vcrole reset`      | Deletes the VC role configuration from the server.                           |
| `.vcrole enable`     | Enables the VC role system without needing to reconfigure the role.          |
| `.vcrole disable`    | Pauses the VC role system (roles will no longer be assigned/removed).        |

***

## How It Works

* **Instant Assignment:** ZEON uses high-speed Redis caching to detect voice state updates instantly, assigning the role the moment a user connects.
* **Auto-Cleanup:** If the assigned VC role is deleted from the server, ZEON automatically deletes the VC role configuration to prevent errors.
* **Bot Ignored:** The VC Role system ignores bots, meaning other bots in your server will not trigger role assignments.