ReactionBot Documentation
Single vs Multi Mode
Learn the difference between Single Mode and Multi Mode role groups and when each should be used.
ReactionBot allows role mappings to be grouped together. Groups can operate in either Single Mode or Multi Mode, giving you complete control over how members receive roles.
What Is a Role Group?
A role group is a collection of reaction role mappings that work together.
Mappings that share the same Group ID belong to the same role group.
Single Mode
Single Mode allows members to have only one role from a group at a time.
When a member selects a different role within the same group, ReactionBot automatically removes the previous role before assigning the new one.
Common Uses for Single Mode
Color roles.
Region selection.
Platform selection.
Team selection.
Choose one notification preference.
Multi Mode
Multi Mode allows members to receive multiple roles from the same group.
Each reaction is treated independently, allowing members to build a collection of roles.
Common Uses for Multi Mode
Game roles.
Interest categories.
Programming languages.
Pronouns.
Content notifications.
Understanding Group IDs
Mappings with the same Group ID work together.
Mappings with different Group IDs operate independently, even if they appear on the same message.
Choose Group IDs carefully when building larger role menus.
Example
Group 1: Red, Blue, Green (Single Mode).
A member choosing Blue automatically loses Red.
Group 2: Minecraft, Valorant, Rocket League (Multi Mode).
A member may receive all three game roles simultaneously.
Choosing the Right Mode
Use Single Mode whenever members should only have one choice.
Use Multi Mode whenever members should be allowed multiple selections.
Troubleshooting
If Single Mode isn't removing old roles, verify that every mapping belongs to the same Group ID.
If Multi Mode appears to replace roles, verify that the mappings aren't accidentally configured as Single Mode.