Docs
/

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 use the default prefix, a comma.

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

See it in Discord

This is the help card for this command. It uses the same syntax and example as `,help`.

member

,help reactionrole

nearAPP

Command: reactionrole

Let members pick roles with reactions or buttons.

Syntax

,reactionrole <add|remove|list|clear|unique> [args]

Example

,reactionrole!
near help card. Same syntax and example the bot shows for `,help reactionrole`.

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.
PreviousRep RewardsNext chapterEmbed Studio