Reaction Roles

Add or remove roles when a user adds a reaction to a message

The Reaction Roles module allows you to configure messages that allow users to assign and remove roles by reacting to a message.

Common Issues

Experiencing issues with the module? Check out the common issues below. If your issue is not listed in this page, make sure your module is updated to the latest version.

The bot is not reacting to the message

If the bot is not adding the first reaction to the message, try the following steps:

1. Make sure the Remove Reaction setting is disabled.
2. If this didn't solve the issue, add the reaction to the message yourself.

The bot doesn't recognize an emoji

If the bot is not recognizing an emoji and not adding the role, try the following steps:

1. Make sure you added the right unicode character for default emojis, like this: 1️⃣, or the right name for custom emojis. For instance, if your custom emoji is called <:SimpleBotWave:1048697598377189850>, only add SimpleBotWave.

If you're still experiencing issues, join our support server to ask for further help.

---

Settings

Setup

The Reaction Role module has different configurations which change how roles are given or removed.

Message ID

Here you will need to enter the message ID of the message you wish to use as the reaction roles panel.

Reaction Emoji

Here you can enter the emoji that is used on the reaction message, this can be discord emojis or custom emojis.

Roles To Add

Here you can select the roles to add to the user when they react to the message.

Roles To Remove

Here you can select some roles the bot should remove when the user reacts to the message.

Restrict To One Reaction

Here you can enable/disable the option to restrict a user's reaction to one reaction at a time.

Remove Reaction

Here you can enable/disable the option for the bot to remove the user's reaction once they have been given the role.

Blacklisted Roles

Here you can select some roles that are unable to use this reaction message. Users with this role will not be able to react to the message as the bot will instantly delete it.

To save the reaction roles settings, you need to click "Add" in the bottom-right corner of the settings. This will reset the fields so you can set up another reaction role.

Active Reaction Roles

Once you have added a reaction role from the settings above, a new area will appear that contains all the active reaction roles. You may edit / delete any of these active reaction roles on the bottom right of the image below.

To save the edits you made on the reaction role settings, you need to click "Edit" in the bottom-right corner of the settings.

---

Events

Below you may find some information on each event of the module.

Reaction Roles #

Once you add a Reaction Role, the corresponding event will be created. This will handle the newly created Reaction Role.