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

# Autorole

> Automatically assign roles to new human members or bots upon joining the server.

# Autorole System

<Badge variant="elite">Tier 1: Elite</Badge>

> Automatically grant roles to members when they join your server, with separate configurations for human members and bots.

***

## Command Overview

| Command     | Aliases     | Syntax                               | Description                                   | Permissions   |
| :---------- | :---------- | :----------------------------------- | :-------------------------------------------- | :------------ |
| `.autorole` | `autoroles` | `.autorole <subcommand> [arguments]` | Configure automatic role assignments on join. | Administrator |

***

## Subcommands Reference

| Subcommand | Target         | Syntax                                          | Description                                        | Example                          |
| :--------- | :------------- | :---------------------------------------------- | :------------------------------------------------- | :------------------------------- |
| `set`      | `human`, `bot` | `.autorole set <human\|bot> <@role\|roleid>`    | Sets role automatically assigned to humans or bots | `.autorole set human @Member`    |
| `remove`   | `human`, `bot` | `.autorole remove <human\|bot> <@role\|roleid>` | Removes auto-assigned role                         | `.autorole remove human @Member` |
| `reset`    | —              | `.autorole reset`                               | Resets all autorole configurations                 | `.autorole reset`                |
| `config`   | —              | `.autorole config`                              | Displays active autorole configuration             | `.autorole config`               |

***

## Configuration Examples

<Tabs>
  <Tab title="Humans">
    ```bash theme={null} theme={null}
    .autorole set human @Member
    .autorole remove human @Member
    ```
  </Tab>

  <Tab title="Bots">
    ```bash theme={null} theme={null}
    .autorole set bot @Bots
    .autorole remove bot @Bots
    ```
  </Tab>

  <Tab title="View & Reset">
    ```bash theme={null} theme={null}
    .autorole config
    .autorole reset
    ```
  </Tab>
</Tabs>

> \[!IMPORTANT]
> Make sure Raze's highest role is positioned **above** the configured autorole in your server role hierarchy.