A Discord reaction roles bot members run themselves

What it needs

• The bot needs View Channel, Send Messages, Embed Links, Manage Roles, Read Message History and Add Reactions to create and maintain reaction-role panels. Exclusive panels also need Manage Messages to remove a member’s previous reaction. It uses Server Members Intent and Message Content Intent.
• Roles offered by the wizard must be below the bot’s highest role. The wizard excludes @everyone, integration-managed roles and roles already added to that panel.

Setting it up

1. Open Reaction Roles in your bot’s Modules tab and select the server. Enable Reaction Roles defaults to on, Default Panel Channel defaults to None (prompt every time in Discord setup), and Max Roles Per Panel defaults to 20.
2. Default Panel Title defaults to React to get your roles!, Default Panel Description defaults to Click on the reactions below to assign yourself roles., and Panel Embed Color defaults to #5865F2.
3. Allow Role Removal On Reaction Remove and DM On Role Change both default to on. Members Can Pick Only One defaults to off and applies to new panels. Run !reactionrole to choose the channel, map roles to emojis, preview and publish the panel.

Example

For a color-role panel, map 🔴 to Red and 🔵 to Blue, turn on Members Can Pick Only One, then publish it. A member choosing 🔵 receives Blue while Red and its reaction are removed. Use !rrmode <messageId> on or off to change one published panel. When it is off: A member who reacts with both emojis receives Red and Blue independently.

Limits and troubleshooting

Limits

• Max Roles Per Panel accepts 1 to 20 emoji-role pairs. The setup wizard stops offering new roles once the saved maximum is reached.
• Removing a reaction removes only its mapped role when Allow Role Removal On Reaction Remove is on. Turning that setting off keeps the role after the reaction is removed.
• Single-choice is stored per panel. The dashboard toggle supplies the default for new panels; existing panels remain unchanged until you use !rrmode <messageId> on. Removing another member reaction also needs the bot’s Manage Messages permission.

If it doesn’t work

• A role is missing from the wizard: move the bot’s highest role above it, then check that it is not @everyone, integration-managed or already on the panel.
• A reaction does not add a role: make sure Enable Reaction Roles is on and give the bot Manage Roles. Check that the reaction is on a published panel with that emoji mapped to the role.
• A removed reaction leaves the role in place: turn on Allow Role Removal On Reaction Remove for the selected server.
• Single-choice reactions stay visible: give the bot Manage Messages as well as Manage Roles. The role swap still follows Discord’s normal role hierarchy rules.