ReactionBot Documentation
Reaction Role Mappings
Create emoji-to-role mappings that automatically assign or remove Discord roles when members react to a message.
Reaction Role Mappings are the foundation of the Roles module. Each mapping connects an emoji reaction to a Discord role, allowing members to assign themselves roles simply by reacting to a message.
How Reaction Role Mappings Work
Each mapping links one emoji to one Discord role.
When a member reacts with that emoji, ReactionBot automatically assigns the configured role.
If enabled, removing the reaction can also remove the assigned role.
Creating a Mapping
Open the Roles section of the dashboard and create a new mapping.
Select the Discord channel containing your message, enter the Message ID, choose an emoji, and select the Discord role that should be assigned.
Once saved, ReactionBot immediately begins monitoring that message.
Channel
Choose the channel containing the message members will react to.
ReactionBot must have permission to view this channel and monitor reactions.
Message ID
Each mapping targets one specific Discord message.
Enable Developer Mode in Discord, right-click the message, and select Copy Message ID.
Emoji
Choose the emoji members must react with.
Both standard Unicode emojis and supported custom server emojis may be used.
Role
Select the Discord role that should be assigned.
ReactionBot must be able to manage the selected role.
Remove Role on Unreact
When enabled, removing the reaction also removes the assigned role.
When disabled, members keep the role even after removing their reaction.
Ignore Bot Reactions
Ignore Bot Reactions prevents other bots from triggering role assignments.
Most servers should leave this enabled.
Editing a Mapping
Mappings can be edited at any time from the dashboard.
You can change the emoji, role, message, or other settings without creating a new mapping.
Deleting a Mapping
Deleting a mapping stops ReactionBot from monitoring that message.
Existing member roles are not automatically removed when a mapping is deleted.
Common Uses
Self-assignable game roles.
Platform selection (PC, Xbox, PlayStation).
Color roles.
Notification opt-in roles.
Pronoun roles.
Region selection.
Required Permissions
ReactionBot requires View Channels, Read Message History, Add Reactions, and Manage Roles.
Its highest role must also be above every role it assigns.
Troubleshooting
Verify the Message ID is correct.
Ensure the selected emoji matches the emoji members are using.
Confirm ReactionBot has Manage Roles permission.
Check that ReactionBot's highest role is above the assigned role.