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

# Auto Roles

> Automatically assign roles to new members and bots when they join your server.

The Auto Roles module automatically assigns roles to new members the moment they join your server. You can configure separate role lists for **human users** and **bots**, ensuring each gets the correct permissions on arrival.

<Note>
  **Required Permission:** [Server Owner](/permissions/hierarchy), [Extra Owners](/permissions/extra-owners), and [Admin Access](/permissions/admin-access) can manage autoroles.
</Note>

***

## Quick Setup

<Steps>
  <Step title="Add a Role for Humans">
    ```bash theme={null}
    .autorole humans add @Member
    ```
  </Step>

  <Step title="Add a Role for Bots">
    ```bash theme={null}
    .autorole bots add @Bot
    ```
  </Step>

  <Step title="Verify Your Setup">
    ```bash theme={null}
    .autorole show
    ```

    This displays all configured autoroles for both humans and bots.
  </Step>
</Steps>

***

## Human Autoroles

Roles assigned automatically to every **human user** that joins.

| Command                         | Description                                |
| :------------------------------ | :----------------------------------------- |
| `.autorole humans add @role`    | Add a role to the human autorole list      |
| `.autorole humans remove @role` | Remove a role from the human autorole list |
| `.autorole humans show`         | Display all human autoroles                |
| `.autorole humans reset`        | Clear all human autoroles                  |

***

## Bot Autoroles

Roles assigned automatically to every **bot** that is added to the server.

| Command                       | Description                              |
| :---------------------------- | :--------------------------------------- |
| `.autorole bots add @role`    | Add a role to the bot autorole list      |
| `.autorole bots remove @role` | Remove a role from the bot autorole list |
| `.autorole bots show`         | Display all bot autoroles                |
| `.autorole bots reset`        | Clear all bot autoroles                  |

***

## Enable / Disable

You can temporarily disable the entire autorole system without losing your configured roles.

| Command             | Description                                        |
| :------------------ | :------------------------------------------------- |
| `.autorole enable`  | Turn on the autorole system                        |
| `.autorole disable` | Turn off the autorole system (config is preserved) |

***

## Limits & Restrictions

<Warning>
  * **Maximum 5 roles** for humans and **5 roles** for bots per server.
  * **Managed roles** (roles owned by integrations like Nitro Booster) cannot be used.
  * **Dangerous permission roles** (Administrator, Manage Server, Ban Members, etc.) are automatically blocked.
  * The bot's highest role must be **above** the autorole in the role hierarchy, or assignment will silently fail.
</Warning>