Skip to main content

Reaction Roles

Reaction Roles are handled through the Role Menus system when a menu is posted as reactions.

Plan Required​

Normal.

Required Bot Permissions​

  • Manage Roles
  • Add Reactions
  • Read Message History
  • Send Messages
  • Embed Links

Setup​

/modules enable role_menus
/rolemenu create
/rolemenu add-role
/rolemenu post

Example Setup​

/rolemenu post menu:Notifications mode:reactions

If the exact mode option differs in your build, use /rolemenu post and choose the reaction menu option exposed by Discord.

Testing​

React to the posted menu and confirm the role is added or removed.

Common Issues​

  • Reaction ignored: check Add Reactions, Read Message History, and role hierarchy.
  • Role is managed: Discord integration roles cannot be assigned by Grimoire.
/rolemenu list
/diagnostics module module:role_menus