Auto Roles
Let members assign themselves roles with button panels.
Overview#
Auto Roles let you create self-service role panels: embed messages with buttons that members click to add or remove roles. Use them for notification opt-ins, color roles, interest groups, pronoun roles, or any other self-assignable role. Panels can be created with the /autorole create command or managed through the dashboard.
How to Set Up#
- Go to the dashboard and select your server
- Navigate to the Auto Roles section
- Click Create Panel to start a new role panel
- Set the panel's title, content, color, and optional image
- Add roles to the panel. For each role, set a button label that members will see
- Save the panel as a draft or publish it immediately to a channel
- Members can now click buttons on the panel to toggle roles on and off
Creating via Discord#
You can also create panels with the bot command:
/autorole create
The bot will walk you through panel setup interactively. You can then manage and edit the panel from the dashboard.
Configuration Options#
Panel Settings#
| Setting | Description |
|---|---|
| Title | The heading displayed on the panel embed |
| Content | Description or instructions shown in the embed body |
| Color | Accent color of the embed sidebar |
| Image | An optional image displayed in the embed |
| Status | Draft (hidden) or Published (visible to members) |
Role Buttons#
Each role added to a panel gets its own button:
| Setting | Description |
|---|---|
| Role | The server role that will be assigned or removed |
| Button Label | The text displayed on the button |
You can add multiple roles to a single panel. Members click a button to receive the role; clicking again removes it.
Tips#
- Group related roles into one panel. For example, put all color roles on one panel and all notification roles on another. This keeps things organized and easy to find.
- Use draft mode to prepare panels before publishing. This lets you review the layout and make sure all roles are correct.
- Place panels in a dedicated channel like #roles or #self-assign so members know exactly where to go.
- Write clear content on each panel explaining what the roles do. Members are more likely to pick roles when they understand the purpose.
- Make sure the bot's role is above the roles it assigns in your server's role hierarchy. Discord requires this for the bot to grant roles to members.
- Use the dashboard to edit panels after creation. You can add or remove roles, change labels, and update the embed without deleting and recreating the panel.
- Multiple panels per channel work well for servers with many self-assignable roles: break them into logical categories.