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

# Automatic roles

> Roles granted on join, for boosting, for advertising the server, or for wearing the server tag.

Roles members get without asking — either automatically on join, or as a reward for doing something.

## Autoroles

Roles handed out the moment someone joins.

<CodeGroup>
  ```javascript Add one theme={null}
  !autorole add @Member
  ```

  ```javascript Several theme={null}
  !autorole add @Member
  !autorole add @Unverified
  ```

  ```javascript Remove theme={null}
  !autorole remove @Member
  ```

  ```javascript List theme={null}
  !autorole list
  ```

  ```javascript Clear theme={null}
  !autorole clear
  ```
</CodeGroup>

Requires **Manage Roles**.

<Warning>
  If your server has a membership screening rule ("Complete the rules screening"), members are technically in the server but **pending** before they accept. Autoroles apply after they accept, not on the initial join — which is the behaviour you want, but catches people out when testing.
</Warning>

## Booster roles

Boosters get a personal role they name and colour themselves. It's the single most reliable boost incentive.

### For boosters

<CodeGroup>
  ```javascript Create one theme={null}
  !boosterrole #ff5c8a
  ```

  ```javascript Match your avatar theme={null}
  !boosterrole dominant
  ```

  ```javascript Name it theme={null}
  !boosterrole rename my role
  ```

  ```javascript Give it an icon theme={null}
  !boosterrole icon 🌸
  !boosterrole icon (attach an image)
  ```

  ```javascript Delete it theme={null}
  !boosterrole remove
  ```
</CodeGroup>

`boosterrole dominant` pulls the colour straight out of their avatar, which is the option most people end up using. Aliases for the group: `color`, `br`, `cr`.

### Sharing

```javascript theme={null}
!boosterrole share @friend
!boosterrole share list
!boosterrole share remove @Role
!boosterrole share clear
```

A booster can hand their custom role to other members. `boosterrole share remove` is what the *recipient* runs to drop a role they were given.

### For admins

<CodeGroup>
  ```javascript Where booster roles sit theme={null}
  !boosterrole base @Booster
  ```

  ```javascript Let non-boosters make one theme={null}
  !boosterrole include @VIP
  !boosterrole include list
  ```

  ```javascript Cap how many can share one role theme={null}
  !boosterrole share limit 3
  ```

  ```javascript Tidy up positions theme={null}
  !boosterrole sync
  ```

  ```javascript See them all theme={null}
  !boosterrole list
  ```

  ```javascript Delete every booster role theme={null}
  !boosterrole clear
  ```
</CodeGroup>

`boosterrole base` sets the position new booster roles are created at, so they cluster in one place instead of scattering through your role list. `boosterrole sync` (alias `organized`) re-sorts existing ones and cleans up roles whose owner stopped boosting.

Requires **Manage Roles**; `clear` requires **Administrator**.

## Vanity roles

Reward members who put your server's vanity URL in their custom status.

Only available if your server **has** a vanity URL (level 3 boosts).

<CodeGroup>
  ```javascript Set the reward role theme={null}
  !vanity role @Advertiser
  ```

  ```javascript Announce it theme={null}
  !vanity channel #general
  ```

  ```javascript Customise the announcement theme={null}
  !vanity message {content: thanks {user.mention} for repping us} {description: you got {role.mention}}
  ```

  ```javascript Check the setup theme={null}
  !vanity settings
  ```

  ```javascript Reset everything theme={null}
  !vanity reset
  ```
</CodeGroup>

mira watches custom statuses. When someone's contains your vanity — `/mira` or `discord.gg/mira` — they get the role. When they remove it, the role goes.

Requires **Manage Roles**. Aliases: `vr`.

## Server tag roles

Discord's **server tags** feature lets members display a small server badge next to their name. This rewards them for using yours.

Only available if your server has the tags feature enabled.

<CodeGroup>
  ```javascript Set the reward role theme={null}
  !tag role @Repping
  ```

  ```javascript Announce it theme={null}
  !tag channel #general
  ```

  ```javascript Customise the announcement theme={null}
  !tag message {content: {user.mention} is repping the tag} {description: have {role.mention}}
  ```

  ```javascript Backfill existing users theme={null}
  !tag sync
  ```

  ```javascript Check the setup theme={null}
  !tag settings
  ```
</CodeGroup>

`tag sync` scans the whole member list and grants the role to everyone already wearing the tag. Run it once after setting things up.

Requires **Administrator**. Aliases: `badge`, `servertag`, `guildtag`.

## Level roles

Roles granted at level milestones. Covered fully on the [Levels](/setup/levels#role-rewards) page:

```javascript theme={null}
!level role add 10 @Regular
!level role add 25 @Veteran
!level role stack
```

## Command reference

| Command                              | Permission      | Description              |
| ------------------------------------ | --------------- | ------------------------ |
| `autorole add <role>`                | Manage Roles    | Grant on join            |
| `autorole remove <role>`             | Manage Roles    | Stop granting            |
| `autorole list`                      | Manage Roles    | View autoroles           |
| `autorole clear`                     | Manage Roles    | Remove all               |
| `boosterrole <color>`                | —               | Create your booster role |
| `boosterrole dominant`               | —               | Colour from your avatar  |
| `boosterrole rename <name>`          | —               | Rename it                |
| `boosterrole icon [icon]`            | —               | Set an icon              |
| `boosterrole remove`                 | —               | Delete yours             |
| `boosterrole share <member>`         | —               | Share with someone       |
| `boosterrole share list`             | —               | Who has yours            |
| `boosterrole base [position] <role>` | Manage Roles    | Where booster roles sit  |
| `boosterrole include <role>`         | Manage Roles    | Let a role create one    |
| `boosterrole share limit <amount>`   | Manage Roles    | Cap sharing              |
| `boosterrole sync`                   | Manage Roles    | Reposition and clean up  |
| `boosterrole list`                   | Manage Roles    | All booster roles        |
| `boosterrole clear`                  | Administrator   | Delete them all          |
| `vanity role <role>`                 | Manage Roles    | Reward role              |
| `vanity channel <channel>`           | Manage Channels | Announcement channel     |
| `vanity message <script>`            | Manage Messages | Announcement text        |
| `vanity settings`                    | Manage Server   | View configuration       |
| `vanity reset`                       | Manage Roles    | Clear configuration      |
| `tag role <role>`                    | Administrator   | Reward role              |
| `tag channel <channel>`              | Administrator   | Announcement channel     |
| `tag message <script>`               | Administrator   | Announcement text        |
| `tag sync`                           | Administrator   | Backfill existing users  |
| `tag settings`                       | Administrator   | View configuration       |
| `tag reset`                          | Administrator   | Clear configuration      |

<Note>
  For roles members pick themselves, see [Self-assignable roles](/setup/self-roles). For moderator role commands — mass assignment, temp roles, role links — see [Managing roles](/moderation/roles).
</Note>