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

# Vanity Rewards

> Reward users with role(s) when they rep your server vanity.

### Description

Reward users with role(s) when they rep your vanity. Note: assumes `,` is your server prefix or self prefix.

<Warning>
  Loti must be above the role you want to assign in the role hierarchy.
</Warning>

<Note>
  You can now use `/vanity wizard` for a simpler setup process for vanity rewards.
</Note>

### Set vanity

<CodeGroup>
  ```plaintext Syntax theme={null}
  ,vanity set (vanity)
  ```

  ```plaintext Example theme={null}
  ,vanity set /relate
  ```
</CodeGroup>

* **(vanity)**: The vanity URL or keyword.
* **Permissions**: Manage Guild, Manage Roles

### Vanity channel

<CodeGroup>
  ```plaintext Syntax theme={null}
  ,vanity channel (channel)
  ```

  ```plaintext Example theme={null}
  ,vanity channel #/relate
  ```
</CodeGroup>

* **(channel)**: The channel where the bot will send vanity messages.
* **Permissions**: Manage Guild, Manage Roles

### Vanity rewards add

<CodeGroup>
  ```plaintext Syntax theme={null}
  ,vanity rewards add (role)
  ```

  ```plaintext Example theme={null}
  ,vanity rewards add @/relate
  ```
</CodeGroup>

* **(role)**: The role to be assigned; specify as `@role` or role ID.
* **Permissions**: Administrator

### Vanity rewards list

<CodeGroup>
  ```plaintext Syntax theme={null}
  ,vanity rewards list
  ```

  ```plaintext Example theme={null}
  ,vanity rewards list
  ```
</CodeGroup>

* Displays all configured vanity rewards.
* **Permissions**: Administrator

### Vanity rewards remove

<CodeGroup>
  ```plaintext Syntax theme={null}
  ,vanity rewards remove (role)
  ```

  ```plaintext Example theme={null}
  ,vanity rewards remove @/relate
  ```
</CodeGroup>

* **(role)**: Remove a vanity reward from the configured list.
* **Permissions**: Administrator

### Vanity cooldown

<CodeGroup>
  ```plaintext Syntax theme={null}
  ,vanity cooldown (duration)
  ```

  ```plaintext Example theme={null}
  ,vanity cooldown 5m
  ```
</CodeGroup>

* Sets the cooldown for how often vanity messages are sent.
* **Permissions**: Manage Guild, Manage Roles

### Vanity message

<CodeGroup>
  ```plaintext Syntax theme={null}
  ,vanity message (message)
  ```

  ```plaintext Example theme={null}
  ,vanity message {user.mention} has been given {role.mention} for having {vanity} in their status.
  ```

  ```plaintext Example (embed) theme={null}
  ,vanity message {embed}{title: Thanks For Repping {user.name}}
  ```
</CodeGroup>

* **(message)**: Custom message sent in the vanity channel. Supports [variables](../other/variables.mdx).
* **Permissions**: Manage Guild, Manage Roles

### Vanity settings

<CodeGroup>
  ```plaintext Syntax theme={null}
  ,vanity settings
  ```

  ```plaintext Example theme={null}
  ,vanity settings
  ```
</CodeGroup>

* View the vanity configuration in a readable format.
* **Permissions**: Manage Guild, Manage Roles

### Vanity remove

<CodeGroup>
  ```plaintext Syntax theme={null}
  ,vanity remove
  ```

  ```plaintext Example theme={null}
  ,vanity remove
  ```
</CodeGroup>

* Removes the vanity settings for the guild.
* **Permissions**: Manage Guild, Manage Roles