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

# Auto-Roles

> Automatically assign roles to new members upon joining your server.

# Auto-Roles

The **Auto-Role** system ensures that every new member is instantly integrated into your community by assigning them one or more roles as soon as they join.

## Interactive Configuration

Veronica uses a sophisticated, button-based panel for managing your auto-roles.

<Steps title="Initial Configuration">
  <Step title="Open the Panel">
    Launch the interactive auto-role manager:

    ```bash theme={null}
    /autorole
    ```

    <Check>Interactive panel active.</Check>
  </Step>

  <Step title="Add a Role">
    Click the **Add Role** button. The bot will prompt you to mention the role or provide a Role ID.
    <Check>Role registered for auto-assignment.</Check>
  </Step>

  <Step title="Security Verification">
    If the role you select has **Dangerous Permissions**, Veronica will issue a warning.
    <Check>Permissions audited and verified.</Check>
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Welcome System" icon="hand-wave" href="/setups/welcome">
    Link roles with your custom greeting messages.
  </Card>

  <Card title="Verification" icon="user-check" href="/setups/verification">
    Use auto-roles as part of your server gatekeeping flow.
  </Card>
</CardGroup>

## Command Reference

| Command            | Description                           | Permission      |
| :----------------- | :------------------------------------ | :-------------- |
| `/autorole`        | Open the interactive management panel | `Manage Server` |
| `/autorole add`    | Quickly add a role to the join list   | `Manage Server` |
| `/autorole remove` | Remove a role from the join list      | `Manage Server` |
| `/autorole clear`  | Delete all configured auto-roles      | `Manage Server` |

## Security Features

Veronica prioritizes your server's safety with several built-in checks:

* **Hierarchy Check:** Veronica can only assign roles that are positioned **lower** than its own highest role in the Discord settings.
* **Dangerous Permission Guard:** Automaticaly detects and warns against auto-assigning roles with destructive capabilities (e.g., Manage Channels, Kick/Ban).
* **Managed Role Protection:** Prevents you from auto-assigning roles that belong to other bots or integrations.

## Interaction Panel

The `/autorole` panel displays your current configuration in real-time:

```
🛡️ Auto-Role Configuration

Current Roles:
- @Member
- @Verified
- @Unassigned

[Add Role] [Remove Role] [Clear All] [Dismiss]
```

<Tip>
  If you have a verification system, use auto-roles to give everyone an "Unverified" role first, then remove it once they complete your process!
</Tip>

<Warning>
  Always ensure Veronica has the **Manage Roles** permission and that its primary role is above the roles you want it to assign.
</Warning>