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

# Booster Roles

> Empower your server boosters with custom, self-managed roles.

# Booster Roles

Veronica's **Booster Role** system allows your server boosters to create and manage their own unique roles. This premium-tier engagement feature rewards your supporters with visual identity and status.

## For Boosters: Creating Your Role

If you have boosted the server, you can create your custom role in seconds.

<Steps title="Self-Management Workflow">
  <Step title="Create Your Role">
    Choose a name and a hex color for your new identity.

    ```bash theme={null}
    /boosterrole create name:My Awesome Role color:#FF0000
    ```

    <Check>Custom role created and assigned!</Check>
  </Step>

  <Step title="Customize Appearance">
    Update your role's color, use a gradient, or match your avatar.
    <Check>Visual style updated.</Check>
  </Step>

  <Step title="Add an Icon">
    If the server has reached **Boost Tier 2**, set a custom icon or emoji.
    <Check>Role icon active.</Check>
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Booster Messages" icon="heart" href="/setups/booster-messages">
    Learn how to customize the thank-you messages boosters receive.
  </Card>

  <Card title="Vanity URL" icon="globe" href="/overview/features">
    Encourage more boosts to reach Tier 3 and unlock custom URLs.
  </Card>
</CardGroup>

## Command Reference

### Booster Commands

| Command                  | Description                              |
| :----------------------- | :--------------------------------------- |
| `/boosterrole create`    | Create your unique booster role          |
| `/boosterrole rename`    | Change the name of your role             |
| `/boosterrole color`     | Update your role's hex color or gradient |
| `/boosterrole icon`      | Set a custom role icon (Tier 2 required) |
| `/boosterrole dominant`  | Sync color with your Discord avatar      |
| `/boosterrole random`    | Sets a completely random color           |
| `/boosterrole share`     | Grant another member access to your role |
| `/boosterrole sharelist` | View who is currently sharing your role  |
| `/boosterrole remove`    | Permanently delete your custom role      |

### Staff/Admin Commands

| Command               | Description                                     | Permission      |
| :-------------------- | :---------------------------------------------- | :-------------- |
| `/boosterrole limit`  | Set max booster roles allowed per user          | `Manage Server` |
| `/boosterrole base`   | Set the role hierarchy anchor for booster roles | `Manage Server` |
| `/boosterrole filter` | Blacklist specific words from role names        | `Manage Server` |
| `/boosterrole link`   | Manually link an existing role to a member      | `Manage Server` |
| `/boosterrole award`  | Set a role to be given automatically on boost   | `Manage Server` |

## Advanced Configuration

### Role Hierarchy (Base Role)

To ensure booster roles don't interfere with your staff hierarchy, use the base role anchor. All new booster roles will be created **one position above** the specified base role.

```bash theme={null}
/boosterrole base role:@BoosterAnchor
```

### Gradient Colors

Veronica supports "blended" gradient colors by providing a second hex code:

```bash theme={null}
/boosterrole color color:#FF0000 color2:#0000FF
```

The bot will automatically blend these two colors to create a unique hybrid shade.

<Note>
  Booster roles are automatically removed if the member stops boosting the server, ensuring your role list stays clean.
</Note>

<Tip>
  Set a `sharelimit` to control how many custom roles a single member can wear simultaneously!
</Tip>