🎭 Reaction Roles

🎭 Reaction Roles

Members can now self-assign roles by reacting to a message or clicking a button — create and publish panels entirely from the web panel.


How it works

  1. Go to Panel → your server → Features and enable Reaction Roles
  2. Open the Reaction Roles page and create a panel
  3. Fill in the message content, pick a Discord channel, map emojis to roles
  4. Choose a mode and whether to use buttons or reactions
  5. Click Publish — YAWBDB posts the message to Discord instantly

If you change the channel or content after publishing, the bot automatically deletes the old message and posts a new one in the right place.


Modes

Four modes control what happens when a member reacts or unreacts:

  • Add-only — reacting grants the role; removing the reaction does nothing
  • Toggle — reacting grants the role; removing the reaction removes it
  • Unique — only one role at a time; switching reaction removes the previous role and grants the new one
  • Verify — reacting grants the role permanently; it can never be self-removed

Unique is useful for color or team roles where members should hold only one at a time.

Verify is useful for rules acceptance — once a member reacts, the role is theirs and stays.


Buttons vs reactions

Toggle Use buttons on a panel to replace emoji reactions with Discord button components. Each button is labeled with the emoji and role name.

  • Up to 25 roles per panel (5 rows × 5 buttons)
  • Confirmation is ephemeral — only the member who clicked sees it
  • Works with all four modes

Managing panels

Each panel shows a Draft or Published status. Panels stay as drafts until you explicitly publish them — useful for preparing content before it goes live.

You can have multiple panels per server, each targeting a different channel with different roles and modes.


Configuration

Panel → your server → Features → enable Reaction Roles → open Reaction Roles


— The YAWBDB Team