Reaction Roles
Let members self-assign roles by reacting to messages. Set up reaction roles with custom emojis and link them to existing messages.
What are reaction roles?
Reaction roles let members assign roles to themselves by clicking a reaction on a message. This is perfect for opt-in roles like notification pings, game roles, color roles, or pronoun roles.
When a member reacts, they get the role. When they remove their reaction, the role is removed. It's fully self-service.
Adding a reaction role
The simplest way to create a reaction role is to let Nevi generate the message for you.
Usage
/reactionrole add <emoji> @Role
Example
/reactionrole add 🎮 @Gamer
Nevi will automatically create a message in the current channel with the emoji as a reaction. You can add multiple reaction roles to the same message by running the command again. Nevi will add the new emoji to the existing message.
Adding to an existing message
If you already have a message (like a rules post or a formatted role menu) that you want to attach reaction roles to, specify the message ID and channel.
Usage
/reactionrole add <emoji> @Role [message_id] [#channel]
Example
/reactionrole add 🎮 @Gamer 1234567890 #roles
To get a message ID, enable Developer Mode in your Discord settings (Settings → Advanced → Developer Mode), then right-click any message and select Copy Message ID.
Removing reaction roles
Remove a reaction role when you no longer want it to be available.
Usage
/reactionrole remove <message_id> <emoji>
Specify the message ID and emoji to remove. The emoji will be removed from the message, and members will no longer be able to self-assign that role through reactions. Members who already have the role will keep it.
Listing reaction roles
View all active reaction roles in your server.
Usage
/reactionrole list
This shows every reaction role with its emoji, the role it assigns, and the message/channel it's attached to.
Tips & best practices
Make the most of your reaction roles with these tips:
Role hierarchy
Nevi's role must be above every role it needs to assign. If it's not, the reaction will work but the role won't be given. Check Server Settings → Roles and drag Nevi's role higher.
Use a dedicated #roles channel
Create a read-only channel where members can only add reactions but can't send messages. This keeps the role menu clean and easy to find.
Custom emojis work too
You can use custom server emojis for a more branded look. Just make sure the emoji is from the same server or Nevi has access to it.
Combine with autoroles
Use autoroles for roles everyone should have, and reaction roles for optional roles members choose themselves.
Related Commands
/reactionrolemanagementRequires adminManage reaction roles (react to get a role)