Reaction Roles
Allow members to self-assign roles by reacting to messages.
Overview
Reaction roles are an easy way for users to pick up roles for notifications, colors, or access to different parts of your server.
Requirements & Limits
- Bot Permission: greed requires the Manage Roles permission.
- Role Hierarchy: greed's role must be above the roles it grants for the feature to work.
- Per-message limit: 20 reaction roles per message.
- Guild limit: 50 total reaction roles per server (non-premium) or 500 (premium).
- Role Hierarchy: greed's role must be positioned above any roles assigned through reaction roles.
Configuration
To set up a reaction role, you need a message link, the emoji, and the role name.
,reactionrole add (message_link) (emoji) (@role)
You can add multiple different emojis to the same message to create a full reaction-based menu. Each emoji can be linked to a different role.
The message link can be obtained by right-clicking a message and selecting Copy Message Link.
Managing Reaction Roles
Viewing existing roles
Use the list command to see all reaction roles currently active in your server.
,reactionrole list
Removing a reaction role
If you no longer want a specific reaction role, you can remove it using the same message link and emoji.
,reactionrole remove (message_link) (emoji)
Clearing all roles
To remove every reaction role from the entire server, use the clear command.
,reactionrole clear
greed will automatically attempt to add the reaction to the message when you create the reaction role. Make sure the bot has permission to react in that channel!
Reaction roles persist across bot restarts and survive message edits. However, if the message is deleted, the reaction role becomes inaccessible but remains in the database until manually removed.