Reaction Roles

What are Reaction Roles?

Reaction roles are roles you can get by reacting to a message. These can be color roles, notification roles, and much more! You can set these up easily by following these steps.

Preparation

Mobile Users: For this guide, you will need developer tools enabled. For more information on enabling developer tools, check out this guide by the Discord team.

Step 1: Message

In your server, choose a channel that you would like the reaction role message to be in. Then, send a message instructing users to react with an emoji to get a role.

Step 2: Role

Create the role in your server you would like users to get when reacting.

Step 3: Creating the Reaction Role

In any channel, run ch!rr create. This will start the reaction role creation process.

If the bot asks you to upvote, press the link that says Click Here, and complete the process there. Upvoting limitations can be bypassed by purchasing premium, then run ch!rr create command again to continue.

The bot is now asking for the channel that the reaction role will be in. Send the channel mention that the message you sent earlier is in.

Ex. #get-roles

Desktop Users: Next to the message you sent earlier, click the three dots (•••) button, and press "Copy Message Link", and paste it into the channel you are doing the setup process in.

Mobile Users: Make sure you followed the step earlier here, and then hold down on the message you sent earlier. A new menu will appear, and you should see a button at the bottom saying "Copy ID". Paste this in the channel you are doing the setup process in.

Now, you need to send the emoji you would like users to react with. This can be a default Discord emoji, or a custom one! Ex. :green:

Now, send the name of the role you would like users to get when reacting. Make sure ChannelBot's role is above this role or it will not work.

If you see this message, you have successfully created the reaction role! If you don't see this, or an error happened early on, check out this.

Step 4: Testing

To test that the reaction role works, go to the message you sent in the beginning. If you see a emoji, the reaction role worked. Click on the emoji and check your roles. If the role was added, your reaction roles are working perfectly. If not, check out this.

Troubleshooting

Here are some common mistakes and how to fix them.

  • If the bot says "invalid reaction" or doesn't respond after sending the emoji, make sure that you sent am emoji from the server, or a default discord one.

  • If the bot says "invalid role", make sure that the role name you sent is a role in your server.

  • If no emoji shows, make sure that the bot has permissions to react to messages in the channel. A simple way to confirm this is by giving the bot "Administrator" permissions.

  • If reacting to the message does not give a role, make sure that ChannelBot has a role above the role you are trying to add.

If you are still confused or need help, please join our support server.