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

# Vanity Roles

Reward your members for advertising your server in their status.

<Warning>
  Your server must be **Level 3** with at least **14 boosts** to use any of the commands.
</Warning>

<Info>
  All commands are **slash commands** and can be accessed by typing `/vanity` in a text channel.
</Info>

### Setting the vanity to be monitored

You’ll need to set what vanity you want to monitor. You can do this by using the `/vanity set` command.

<Tip>
  It’s recommended to prefix the substring with a `/` (e.g. `/drown`).
</Tip>

<CodeGroup>
  ```typescript Syntax theme={null}
  /vanity set (substring)
  ```

  ```typescript Example theme={null}
  /vanity set /drown
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/QddIUqwwvj7EFCVJ/images/Screenshot-2026-04-15-at-1.44.30-AM.png?fit=max&auto=format&n=QddIUqwwvj7EFCVJ&q=85&s=7b93c05a98421fef7f2b06ff4a6c40b4" alt="Screenshot 2026 04 15 At 1 44 30 AM" width="860" height="262" data-path="images/Screenshot-2026-04-15-at-1.44.30-AM.png" />
</Frame>

### Setting up roles to reward

You can use the `/vanity role add` command to add a vanity reward.

<Info>
  If you no longer want to reward a role for a vanity, you can use the `/vanity role remove` command.
</Info>

<CodeGroup>
  ```typescript Syntax theme={null}
  /vanity role add (role)
  /vanity role remove (role)
  ```

  ```typescript Example theme={null}
  /vanity role add @Vanity
  /vanity role remove @Vanity
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/QddIUqwwvj7EFCVJ/images/Screenshot-2026-04-15-at-1.46.14-AM.png?fit=max&auto=format&n=QddIUqwwvj7EFCVJ&q=85&s=1086d1520c0f96e86c1c8b4a2a747e14" alt="Screenshot 2026 04 15 At 1 46 14 AM" width="962" height="488" data-path="images/Screenshot-2026-04-15-at-1.46.14-AM.png" />
</Frame>

### Viewing all roles being rewarded

You can use the `/vanity role list` command to view all roles being rewarded.

<Frame>
  <img src="https://mintcdn.com/drown/QddIUqwwvj7EFCVJ/images/Screenshot-2026-04-15-at-1.46.54-AM.png?fit=max&auto=format&n=QddIUqwwvj7EFCVJ&q=85&s=e8ddbe85aa90db247cc60061f6bd05ec" alt="Screenshot 2026 04 15 At 1 46 54 AM" width="832" height="454" data-path="images/Screenshot-2026-04-15-at-1.46.54-AM.png" />
</Frame>

### Setting up the award message

You can set a thank you message for when a user advertises your server in their status.

<Info>
  The `message` parameter can be raw text or an **embed** with dynamic **variables**.
</Info>

<CodeGroup>
  ```typescript Syntax theme={null}
  /vanity message (message)
  ```

  ```typescript Example theme={null}
  /vanity message thank you {user.mention}
  /vanity message {embed}$v{message: {user.mention}}$v{description: thank you for advertising our server!}
  ```
</CodeGroup>

### Setting where the message is sent

You can use the `/vanity award channel` command to set where the message is sent.

<CodeGroup>
  ```typescript Syntax theme={null}
  /vanity channel (channel)
  ```

  ```typescript Example theme={null}
  /vanity award channel #general
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/QddIUqwwvj7EFCVJ/images/Screenshot-2026-04-15-at-1.47.24-AM.png?fit=max&auto=format&n=QddIUqwwvj7EFCVJ&q=85&s=6f0b8ecf0baadcc0292f2fd35ab13938" alt="Screenshot 2026 04 15 At 1 47 24 AM" width="948" height="272" data-path="images/Screenshot-2026-04-15-at-1.47.24-AM.png" />
</Frame>

### Viewing the vanity roles configuration

You can use the `/vanity config` to view your current vanity roles configuration.

<Frame>
  <img src="https://mintcdn.com/drown/QddIUqwwvj7EFCVJ/images/Screenshot-2026-04-15-at-1.47.50-AM.png?fit=max&auto=format&n=QddIUqwwvj7EFCVJ&q=85&s=3f331a7b0302608ad9b6dadd41f981bc" alt="Screenshot 2026 04 15 At 1 47 50 AM" width="1350" height="664" data-path="images/Screenshot-2026-04-15-at-1.47.50-AM.png" />
</Frame>

### Resetting a configuration

You can use the `/vanity reset` to reset a configuration.

<Frame>
  <img src="https://mintcdn.com/drown/SCEbhYe6l4tsCFFC/images/Screenshot-2026-04-14-at-11.36.03-AM.png?fit=max&auto=format&n=SCEbhYe6l4tsCFFC&q=85&s=5ed5bef61f0ed458b83022ed03fa41c8" alt="Screenshot 2026 04 14 At 11 36 03 AM" width="718" height="536" data-path="images/Screenshot-2026-04-14-at-11.36.03-AM.png" />
</Frame>
