Skip to main content
The Auto Roles module automatically assigns roles to new members the moment they join your server. You can configure separate role lists for human users and bots, ensuring each gets the correct permissions on arrival.
Required Permission: Server Owner, Extra Owners, and Admin Access can manage autoroles.

​
Quick Setup

1

Add a Role for Humans

.autorole humans add @Member
2

Add a Role for Bots

.autorole bots add @Bot
3

Verify Your Setup

.autorole show
This displays all configured autoroles for both humans and bots.

​
Human Autoroles

Roles assigned automatically to every human user that joins.
CommandDescription
.autorole humans add @roleAdd a role to the human autorole list
.autorole humans remove @roleRemove a role from the human autorole list
.autorole humans showDisplay all human autoroles
.autorole humans resetClear all human autoroles

​
Bot Autoroles

Roles assigned automatically to every bot that is added to the server.
CommandDescription
.autorole bots add @roleAdd a role to the bot autorole list
.autorole bots remove @roleRemove a role from the bot autorole list
.autorole bots showDisplay all bot autoroles
.autorole bots resetClear all bot autoroles

​
Enable / Disable

You can temporarily disable the entire autorole system without losing your configured roles.
CommandDescription
.autorole enableTurn on the autorole system
.autorole disableTurn off the autorole system (config is preserved)

​
Limits & Restrictions

  • Maximum 5 roles for humans and 5 roles for bots per server.
  • Managed roles (roles owned by integrations like Nitro Booster) cannot be used.
  • Dangerous permission roles (Administrator, Manage Server, Ban Members, etc.) are automatically blocked.
  • The bot’s highest role must be above the autorole in the role hierarchy, or assignment will silently fail.