What are Reaction Roles?

Reaction Roles allow your members to self-manage their roles by adding/removing a reaction to a message. Reactions correspond to a role which you can configure in this plugin!

Getting Started

1. Navigate to your server's dashboard.
2. Select the Reaction Roles plugin. If it's not enabled, you'll need to enable it.
3. Follow the instructions below.

Creating a Reaction Role

1. Click the "CREATE NEW" button on the top right.
2. Select a "Creation Type":

Use Buttons - Circle will post an embed in the channel you specify in the "Message Channel" box and use buttons. Also, you'll need to specify what the embed should say in the "Message" box.

Use Reactions [legacy] - Circle will post an embed in the channel you specify in the "Message Channel" box. Also, you'll need to specify what the embed should say in the "Message" box.

Use a Custom Message [ID] - Circle will add the reactions you configure to the message you provided in the "Message ID" and "Message Channel" boxes.

3. Click the "ADD EMOJI" button to add a reaction.
4. Select an emoji from the list (custom emojis appear at the very bottom).
5. Append a role to the emoji in the "Select a Role" drop-down.

Direct Message on Role Edit

If you want Circle to send a DM to a member when their role is added/removed, tick the "DM users when they are given or removed from a role" option!

[PREMIUM] Custom DM Messages

Circle Premium users have the ability to specify their own custom DM messages, which Circle will send to users when they join/leave a reaction role. You can specify different DM messages for each reaction role.

1. Follow the above guide to start creating your very own reaction role.
2. Under each role, you will see a "Custom DM Messages" tab, which expands when you click on it.
3. Edit your "Role Join Message" and "Role Leave Message" to whatever you like. The join message will be DMed to users when they join the reaction role, and the leave message will be DMed to users when they leave the reaction role.
4. Once you're happy with your messages, and the rest of your reaction roles, scroll down and press "Save".

Updated on: 09/11/2025