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

# Leveling

> Earn XP from chatting and voice, unlock role rewards and climb the leaderboard.

> [!WARNING]
>
> XP tracking needs an **active Premium subscription** (any tier). If Premium ends, tracking stops but your members' XP and your settings are kept. See [Premium](https://docs.giveawayx.lol/concepts/premium.md).

## How members earn XP

| Source | Default |
| - | - |
| Chatting | 15 XP (plus or minus 10), once every 60 seconds |
| Voice channels | 10 XP per minute |
| Reactions (optional, off by default) | 5 XP (plus or minus 2), once every 30 seconds |

Text and voice XP are tracked **separately**, so the leaderboard can show Text and Voice side by side. A member's total XP combines both.

You can exclude chosen roles, text channels and voice channels from earning XP. Voice XP can also skip members who are muted or deafened.

## For members

> **/rank**
>
> Shows your rank card. Choose a `dark` or `light` theme.

> **/top**
>
> The server leaderboard for `day`, `week`, `month` or `all`, filterable by role.

> [!NOTE]
>
> The rank card is temporarily in maintenance, so `/rank` may show a maintenance message. `/top` works normally.

## For admins: /levelsetup

`/levelsetup` opens a panel where you control everything.

> **XP and cooldowns**
>
> Set XP per message, the random variance, the cooldown, XP per voice minute and XP per reaction. The maximum values depend on your Premium tier.

> **Multipliers and boost events**
>
> Give roles or channels an XP multiplier, or run a timed **XP boost event** such as double XP weekend.

> **Level-up messages**
>
> Write separate messages for text, voice, reaction and DM level-ups, with optional images. Send them in the channel, by DM, both, or turn them off. You can set a dedicated channel for text and voice level-ups.

> **Role rewards**
>
> Give roles at specific levels, for text and voice separately. You can stack rewards, remove the previous reward, or keep only the highest.

> **Streaks**
>
> Reward daily activity with extra XP per streak day (2 percent by default) up to a cap (100 percent by default).

> **Leaderboard timing**
>
> Choose your time zone and when the daily, weekly and monthly leaderboards reset. Leaderboards can be **fixed** (start of the week or month) or **rolling** (the last N days).

## Admin commands

**/setxp** `command`

Set a member's XP. Choose `total`, `text` or `voice`.

**/setlevel** `command`

Set a member's level (0 to 999). Choose `total`, `text` or `voice`, and whether to keep their XP.

## Levels in giveaways

> **[Require a level](https://docs.giveawayx.lol/giveaways/entry-requirements.md)**

> **[Bonus entries by level](https://docs.giveawayx.lol/giveaways/bonus-entries.md)**

> **[Reward XP to winners](https://docs.giveawayx.lol/giveaways/winners-and-claims.md)**


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