Level Autoroles

Level autoroles let you automatically assign Discord roles when members reach a certain level. This gives your members tangible rewards for being active and lets you gate channels, permissions, or cosmetic perks behind activity milestones.

For example, you could grant a "Regular" role at Level 10 that unlocks access to exclusive channels, or a "Veteran" role at Level 50 with a special color in the member list.

To add a level autorole, use the /autorole add command and specify the role and the level at which it should be assigned:

Now, whenever a member reaches Level 10, Nevi will automatically assign them the @Regular role. Members who are already at or above Level 10 will receive the role the next time their XP is recalculated.

By default, autoroles stack. A member at Level 25 would have every autorole from Level 1 through Level 25. If you want a tiered system where members only keep their highest role, use the remove_on_level_change option:

With this setting, the @Beginner role will be removed once the member reaches the next autorole level. For example, if you have @Beginner at Level 1 and @Regular at Level 10, a member who reaches Level 10 will lose @Beginner and gain @Regular.

This creates a clean tiered system where each member only has one level-based role at a time, making the member list cleaner and role colors more meaningful.

A typical tiered autorole setup for a community server:

In this setup, a member at Level 12 would only have @Regular. When they hit Level 25, @Regular is removed and they get @Veteran. The final tier (@Legend at Level 50) is kept permanently since remove_on_level_change is not enabled for it.

Use these commands to view and manage your existing level autoroles:

For autoroles to work, Nevi's own role must be positioned above all the roles it needs to assign in your server's role hierarchy.

If autoroles aren't working, this is the most common cause. See the Permissions Troubleshooting guide for more help.