Roles

,reactionrole

Bind a role to an emoji on any message. Reacting grants the role, removing the reaction takes it back.

Examples on this site start with a comma. Your server can use a different prefix. Change it with `,prefix` or in Basics if you own the server.

Who can run it

Manage Roles

Usage

,reactionrole add <message> <emoji> <@role>
,reactionrole remove <message> <emoji>
,reactionrole list [message]
,reactionrole clear <message|all>
,reactionrole unique <message> <on|off>

Aliases

,reactrole, ,rrole

Examples

,reactionrole add 1234567890 🎮 @Gamer
,reactrole add https://discord.com/channels/1/2/3 :custom: @Notify
,rrole unique 1234567890 on
,reactrole list

Subcommands

  • add. Reacts to the message with the emoji and stores the binding. Accepts a message ID or a full message link from any channel.
    ,reactionrole add <message> <emoji> <@role>
  • remove. Drops one binding and clears the bot reaction.
    ,reactionrole remove <message> <emoji>
  • unique. One role per message. Picking a new emoji removes the previous role and reaction automatically.
    ,reactionrole unique <message> <on|off>
  • clear. Removes every binding on one message, or across the whole server with `all`.
    ,reactionrole clear <message|all>

What it looks like

near APP

,help reactionrole

Bind a role to an emoji on any message. Reacting grants the role, removing the reaction takes it back.

,reactionrole add <message> <emoji> <@role>

Notes

  • The bot role must sit above every role it hands out.
  • Bindings survive restarts. Missing bot reactions are restored on startup.
  • Custom emoji are stored by ID, so renaming the emoji does not break the binding.