Reaction Roles
Reaction roles allow members to assign roles to themselves by clicking a button or adding a reaction to a message. Create role panels for color roles, notification preferences, game roles, and more.
Commands
| Command | Description | Usage |
|---|---|---|
/reactionroles create | Create a new reaction role panel | /reactionroles create |
/reactionroles delete | Delete an existing reaction role panel | /reactionroles delete <message-id> |
/reactionroles list | List all reaction role panels in the server | /reactionroles list |
Dashboard Configuration
The Reaction Roles section of the dashboard provides a visual builder for creating and managing panels.
Creating a Panel
- Choose the target channel where the panel will be posted.
- Write a title and description for the embed.
- Add roles, each with a label and optional emoji.
- Select the mode (see below).
- Choose between button or reaction style.
- Deploy the panel.
The dashboard builder shows a live preview of your panel as you configure it. Use this to fine-tune the appearance before deploying.
Managing Panels
From the dashboard, you can:
- View all active panels and their associated roles
- Edit the roles on an existing panel
- Delete panels you no longer need
Features
Button Roles
Button-based panels display Discord buttons below the embed. Members click a button to toggle a role on or off. Buttons are more reliable than reactions and support custom labels and colors.
Reaction Roles
Reaction-based panels use emoji reactions on the message. Members add a reaction to receive the corresponding role and remove it to lose the role.
Button roles are recommended over reaction roles. Reactions can be lost if the message is edited or if Discord clears the reaction cache, while buttons remain persistent.
Selection Modes
| Mode | Behavior |
|---|---|
| Multi-Select | Members can pick as many roles as they want from the panel |
| Exclusive | Members can only hold one role from the panel at a time (selecting a new one removes the previous) |
Exclusive mode is ideal for color roles or mutually exclusive categories where a member should only have one option.
Multi-select mode is ideal for notification roles, game roles, or any situation where members can belong to multiple groups.
Make sure the bot's role is positioned above all roles in the reaction role panel within the server's role hierarchy. The bot cannot assign roles that are higher than its own.