6 min · Easy

Reaction roles

Bind a role to a reaction on a message. No web canvas.

You will

A reaction grants a role. Removing it takes the role 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.

Before you start

  • near must sit above the role it grants. Have a message id or a message link.

Set it up

  1. Add. Point at a message, then the emoji, then the role. near reacts for you. Removing the reaction takes the role back.
    ,reactionrole add 1234567890 🎮 @Gamer
  2. Unique optional. Turn unique on if this message should only hold one role at a time.
    ,reactionrole unique 1234567890 on
  3. List and remove. List bindings on a message, or remove one emoji.
    ,reactionrole list

Examples

,reactionrole add 1234567890 🎮 @Gamer
,reactionrole unique 1234567890 on
,reactionrole list

Do not

  • Do not bind Administrator. near will not hand that out.

Troubleshooting

  • If the role never applies, it is above near or it is Administrator.
  • If the reaction disappears, the bot cannot add reactions in that channel.

Verify it works

  • React on an alt. Confirm the role appears. Remove the reaction and confirm it drops if that mode is on.