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

# Ranks

## Enable / Disable Command

```txt theme={null}
/ranks <enable/disable>
```

### Description

Enables / Disables the leaderboard and XP collection for the server.

`disable` asks for confirmation first. While the leaderboard is disabled, Members stop earning XP and the leaderboard page, `/rank` and [`/leaderboard`](https://docs.utilbot.co/commands/rank/leaderboard) are unavailable. Existing XP and levels are kept.

### Permission

`ADMINISTRATOR`

### Arguments

| Name | Type | Description | Sample Data |
| - | - | - | - |
| | | | None |

***

## Config Command

```txt theme={null}
/ranks config [public] [join-enabled] [invite-channel]
```

### Description

Shows or manages the leaderboard settings. Without arguments, the current settings are shown.

### Permission

`ADMINISTRATOR`

### Arguments

| Name | Type | Description | Sample Data |
| - | - | - | - |
| public | Boolean | Whether the leaderboard can be viewed without being a member of the server | True |
| join-enabled | Boolean | Whether users can join the server from its web page (the leaderboard and Guild Discovery) | True |
| invite-channel | Channel | The text or announcement channel used to invite users that join from the web page | #welcome |

***

## Roles Command

```txt theme={null}
/ranks roles <enable/disable/list>
/ranks roles add <rank> <role>
/ranks roles remove <rank>
```

### Description

Manages the rank roles, which Members receive automatically when they reach a rank.

* `enable` / `disable` switches the automatic assignment of rank roles on or off.
* `list` shows the configured rank roles.
* `add` adds a rank role, or changes the role of a rank that already has one.
* `remove` removes the rank role of a rank.

The role has to be below your own highest role. Only the server owner is exempt from this.

### Permission

`ADMINISTRATOR`

### Arguments

| Name | Type | Description | Sample Data |
| - | - | - | - |
| rank\* | Integer | The rank level at which the role should be assigned, or the rank level to remove | 10 |
| role\*\* | Role | The role to assign at this rank level | @Regular |

`*: This is only available on the 'add' and 'remove' subcommands.`

`**: This is only available on the 'add' subcommand.`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.