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

# Configure Role Rewards for Prowl Leveling Milestones

> Role rewards in Prowl automatically assign Discord roles when members reach XP thresholds — motivating engagement and recognizing your top contributors.

Role rewards let you turn Prowl's leveling system into a progression ladder. Instead of levels being just a number, you can attach real benefits — special Discord roles with their own channel access, colors, or perks — that members automatically receive when they hit key milestones.

## How Role Rewards Work

Every time a member earns XP in your server, Prowl checks their level against your configured role reward thresholds. When a member reaches a threshold level, Prowl automatically assigns the corresponding role — no command needed, no manual intervention required.

<Note>
  Role rewards only fire when a member actively earns XP and levels up. Members who already had enough levels before a reward was added won't receive the role retroactively.
</Note>

## Adding a Role Reward

Use the slash command to set a role reward for a specific level:

```text theme={null}
/level setrole <level> <role>
```

| Parameter | Description                            |
| --------- | -------------------------------------- |
| `level`   | The level at which the role is awarded |
| `role`    | The Discord role to assign             |

You can also configure role rewards from the dashboard under **Leveling → Role Rewards**.

## Example Reward Ladder

Here's a sample progression ladder for a general-purpose community server:

| Level | Role          | Perks                                           |
| ----- | ------------- | ----------------------------------------------- |
| 5     | `🌱 Newcomer` | Access to `#memes` channel                      |
| 10    | `⭐ Regular`   | Access to `#off-topic` and custom color         |
| 20    | `🔥 Veteran`  | Access to `#veteran-lounge` and emoji perks     |
| 50    | `👑 Legend`   | Special colored name, shoutout in announcements |

<Tip>
  Space your early milestones close together (levels 1–10) so new members get rewarding feedback quickly. Spread later milestones further apart (levels 20, 50, 100) to make top-tier roles feel genuinely earned.
</Tip>

## Interaction with Discord Role Hierarchy

Prowl can only assign roles that sit **below its own highest role** in your server's role hierarchy. This is a Discord platform restriction — bots cannot grant roles that are positioned above themselves.

**What this means in practice:**

* Open **Server Settings → Roles** in Discord.
* Find the **Prowl** role (or whatever role was created when you invited the bot).
* Make sure every role you want to use as a reward is **listed below** the Prowl role.
* Drag roles up or down in the list to reorder them.

<Warning>
  If you try to assign a reward role that sits above Prowl in the hierarchy, Prowl will fail silently — the member reaches the level but receives no role, and no error is displayed to them. Always verify your role ordering after setting up new rewards.
</Warning>

The Prowl role itself doesn't need to be at the very top of your hierarchy — it just needs to be above every role it's responsible for managing. A common setup is to place the Prowl role just below your Admin and Moderator roles, and above all member-facing roles.