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

# Auto Roles

> Automatically assign roles to users based on various triggers

<Note>Requires **Manage Roles** permission</Note>

<img src="https://scrumpbot.com/static/images/feature-auto-roles.png" alt="Auto Roles feature" className="w-full" />

## Setting Up Auto Roles

<Steps>
  <Step title="Add auto roles">
    Use `/auto-role add role:` to add a role that will be automatically assigned to new members

    * `role:` = The role to assign to new members when they join

    ```
    /auto-role add role: @Member
    ```
  </Step>

  <Step title="View current auto roles">
    Use `/auto-role list` to view all configured auto roles for your server
  </Step>
</Steps>

## Managing Auto Roles

<Steps>
  <Step title="Remove auto roles">
    Use `/auto-role remove role:` to remove an automatically assigned role

    * `role:` = The role to remove from auto assignment

    ```
    /auto-role remove role: @Member
    ```
  </Step>
</Steps>

## Auto Role Limits

* **Free servers**: Up to 1 auto role
* **Plus servers**: Up to 500 auto roles
* **Custom bots**: Up to 500 auto roles

## How Auto Roles Work

* When a new member joins your server, they will automatically receive all configured auto roles
* Auto roles are assigned immediately upon joining
* You can have multiple auto roles active at the same time
* Auto roles work with any role that the bot has permission to assign