Reaction Role Commands

Set up role assignment from message reactions.

Overview

Reaction roles let users self-assign roles by reacting to a configured message.

You can configure reaction roles in two ways:

  • Slash commands (/emojirole ...) for creating/updating mappings
  • Dashboard for managing mappings on existing messages

emojirole new

Creates a new message with an embed and binds one emoji + role mapping to it.

Usage:

/emojirole new [emoji] [role] [message] [channel]

Example:

/emojirole new 😀 @Announcements "React for announcements" #roles

Parameters:

  • emoji - Any valid Discord emoji
  • role - Role to assign/remove when users react/unreact
  • message - Embed description text shown to users
  • channel - Text channel where the new reaction-role message is posted

Permissions Required:

  • Manage Roles or one of your configured permission roles (admin, mod, trial mod)

Notes:

  • The target role must be lower than the command user's top role
  • The bot must be able to add reactions and manage the target role

emojirole add

Adds a reaction-role mapping to an existing message by message ID.

Usage:

/emojirole add [message_id] [emoji] [role] [optional: channel]

Example:

/emojirole add 123456789012345678 😀 @Announcements #roles

Parameters:

  • message_id - Existing Discord message ID to attach mapping to
  • emoji - Any valid Discord emoji
  • role - Role to assign/remove when users react/unreact
  • channel - Channel containing that message (defaults to current channel)

Permissions Required:

  • Manage Roles or one of your configured permission roles (admin, mod, trial mod)

Notes:

  • If channel is omitted, the command checks the channel where the command was run
  • The message must be accessible to the bot

Dashboard Emoji Roles

Use the dashboard to manage reaction-role mappings without command syntax.

Navigation:

Dashboard -> Select Server -> Emoji Roles

You can:

  • Map role + emoji to an existing message ID
  • Select the source channel for that message
  • Auto-seed the configured reaction (when bot permissions allow)
  • Remove existing mappings

Access Required: Dashboard Editor or Dashboard Admin

Troubleshooting

Reaction doesn't grant role?

  • Verify bot has Manage Roles permission
  • Ensure bot role is above the target role in role hierarchy
  • Confirm mapping exists for the exact message ID + emoji

Command says role is too high?

  • You can only configure roles lower than your highest role

Message not found on /emojirole add?

  • Confirm the message_id is correct
  • Provide channel explicitly if the message is in another channel