Auto Roles
Automatically assign roles when members join your server or reach a specific level.
Join auto roles
Join autoroles are assigned automatically when a new member joins your server. This is useful for giving everyone a default role like "Member" or a color role.
Usage
/autorole add @Role
Example
/autorole add @Member
When no level is specified, the role is treated as a join autorole and will be given to every new member immediately when they join.
Level auto roles
Level autoroles are assigned when a member reaches a specific level in Nevi's leveling system. This lets you reward active members with special roles.
Usage
/autorole add @Role <level>
Example
/autorole add @Veteran 10
The member will receive the role once they reach the specified level. Make sure the experienceEnabled setting is turned on for leveling to work.
Remove on level change
For tiered role systems where you want members to only hold one tier at a time, you can set roles to be removed when a member levels past them.
Usage
/autorole add @Role <level> <removal>
Example tiered setup:
@Bronzeat level 5 (remove on level change)@Silverat level 15 (remove on level change)@Goldat level 30 (remove on level change)@Diamondat level 50
With this setup, when a member reaches level 15 they get @Silver and lose @Bronze. At level 30 they get @Gold and lose @Silver. At level 50 they get @Diamond and lose @Gold.
Managing auto roles
View and remove your configured autoroles at any time.
List All Autoroles
/autorole list
Shows all configured autoroles, including their type (join or level), the level requirement if applicable, and whether they're set to be removed on level change.
Remove an Autorole
/autorole remove @Role
Removes the role from the autorole system. Members who already have the role will keep it. This only stops future automatic assignments.
Tips & troubleshooting
Keep these things in mind when setting up autoroles:
Role hierarchy matters
Nevi's role must be above any role it needs to assign in the server's role list. If Nevi's role is below the autorole, the assignment will silently fail.
Don't use managed roles
Roles created by other bots or integrations (like Nitro Booster) are managed by Discord and can't be assigned by Nevi.
Combine with reaction roles
Use join autoroles for roles everyone should have, and reaction roles for opt-in roles that members choose themselves.
Related Commands
/autorolemanagementRequires ownerManage automatic role assignment on join or level-up