> ## Documentation Index > Fetch the complete documentation index at: https://docs.celestia.rest/llms.txt > Use this file to discover all available pages before exploring further. # Reaction Roles > Let members assign themselves roles by reacting to messages ## Overview Reaction roles allow members to assign themselves roles by clicking reactions on messages. Perfect for role selection panels, color roles, notification preferences, and self-assignable team roles. Members can add or remove roles simply by clicking emoji reactions - no commands needed! *** ## Commands Add a reaction role to a message. ```bash Syntax theme={null} ~reactionrole add <@role> ``` ```bash Example theme={null} ~reactionrole add https://discord.com/channels/123/456/789 🎮 @Gamer ~rr add https://discord.com/channels/123/456/789 🎨 @Artist ~reactionrole add <:custom:123456789> @VIP ``` **Parameters:** * **message\_link** — Link to the message (right-click → Copy Message Link) * **emoji** — Emoji to react with (unicode or custom) * **@role** — Role to assign **What It Does:** * Adds the emoji reaction to the message * Members who react get the role * Removing reaction removes the role * Works with both unicode and custom emojis **Aliases:** `rr add`, `reactionroles add`\ **Permissions:** Administrator Remove a specific reaction role from a message. ```bash Syntax theme={null} ~reactionrole remove ``` ```bash Example theme={null} ~reactionrole remove https://discord.com/channels/123/456/789 🎮 ~rr remove 🎨 ``` **Parameters:** * **message\_link** — Link to the message * **emoji** — Emoji to remove **What It Does:** * Removes the reaction role configuration * Removes the emoji reaction from the message * Members keep the role if they already have it **Aliases:** `rr remove`, `reactionroles remove`\ **Permissions:** Administrator Remove all reaction roles from a message. ```bash Syntax theme={null} ~reactionrole removeall ``` ```bash Example theme={null} ~reactionrole removeall https://discord.com/channels/123/456/789 ~rr removeall ``` **What It Does:** * Removes all reaction role configurations from the message * Clears all reactions from the message * Shows count of removed reaction roles **Aliases:** `rr removeall`, `reactionroles removeall`\ **Permissions:** Administrator View all reaction roles configured in your server. ```bash Syntax theme={null} ~reactionrole list ``` ```bash Example theme={null} ~reactionrole list ~rr list ``` **What It Shows:** * All messages with reaction roles * Emojis and their assigned roles * Jump links to each message * Organized by message **Aliases:** `rr list`, `reactionroles list`\ **Permissions:** Administrator Reset all reaction roles in the server. ```bash Syntax theme={null} ~reactionrole reset ``` ```bash Example theme={null} ~reactionrole reset ~rr reset ``` **What It Does:** * Removes ALL reaction role configurations * Shows count of removed roles * Cannot be undone This removes all reaction roles from your entire server. **Aliases:** `rr reset`, `reactionroles reset`\ **Permissions:** Administrator *** ## How It Works Create an embed or message explaining the roles: ```bash theme={null} ~embed create {embed} $v{title: Select Your Roles} $v{description: React to get roles! 🎮 - Gamer 🎨 - Artist 📚 - Reader} {embed} ``` Add reaction roles to the message: ```bash theme={null} ~rr add 🎮 @Gamer ~rr add 🎨 @Artist ~rr add 📚 @Reader ``` Members click reactions to get roles: * Click emoji = get role * Unclick emoji = lose role * Works instantly *** ## Permission Requirements The bot needs: * Manage Roles * Add Reactions * Read Messages * View Channel (for the reaction message) Command Requirements: * **Administrator** — All reaction role commands * **None** — Using reactions (any member) *** ## Role Hierarchy **Important Hierarchy Rules** * Bot's role must be **higher** than roles it assigns * Your role must be **higher** than roles you configure * Bot cannot assign roles equal to or higher than its highest role * Server owner bypasses user hierarchy restrictions *** ## Aliases Full command Short alias Alternative *** ## Usage Examples ```bash theme={null} # 1. Create role panel message ~embed create {embed} $v{title: Role Selection} $v{description: Click reactions to get roles} {embed} # 2. Copy message link (right-click message) # 3. Add reaction roles ~rr add 🎮 @Gamer ~rr add 🎨 @Artist ~rr add 📚 @Reader # 4. Members can now react! ``` ```bash theme={null} # Create color selection ~embed create {embed} $v{title: Choose Your Color} $v{description: 🔴 - Red 🟢 - Green 🔵 - Blue 🟡 - Yellow} {embed} # Add reactions ~rr add 🔴 @Red ~rr add 🟢 @Green ~rr add 🔵 @Blue ~rr add 🟡 @Yellow ``` ```bash theme={null} # Create notification panel ~embed create {embed} $v{title: Notification Settings} $v{description: 📢 - Announcements 🎉 - Events 📰 - News 🎮 - Gaming} {embed} # Add reactions ~rr add 📢 @Announcements ~rr add 🎉 @Events ~rr add 📰 @News ~rr add 🎮 @Gaming ``` ```bash theme={null} # Create team panel ~embed create {embed} $v{title: Join a Team} $v{description: 🔴 - Team Red 🔵 - Team Blue 🟢 - Team Green} {embed} # Add reactions ~rr add 🔴 @Team Red ~rr add 🔵 @Team Blue ~rr add 🟢 @Team Green ``` ```bash theme={null} # View all reaction roles ~rr list # Remove one reaction role ~rr remove 🎮 # Remove all from message ~rr removeall # Reset entire server ~rr reset ``` *** ## Common Use Cases ```bash theme={null} # Members choose their name color ~rr add 🔴 @Red ~rr add 🟠 @Orange ~rr add 🟡 @Yellow ~rr add 🟢 @Green ~rr add 🔵 @Blue ~rr add 🟣 @Purple ``` Let members customize their appearance. ```bash theme={null} # Members control what they're pinged for ~rr add 📢 @Announcements ~rr add 🎉 @Events ~rr add 🎁 @Giveaways ``` Reduce unwanted pings, increase engagement. ```bash theme={null} # Members show what they play/like ~rr add 🎮 @Valorant ~rr add ⚔️ @Minecraft ~rr add 🎨 @Artist ~rr add 💻 @Developer ``` Help members find others with shared interests. ```bash theme={null} # Members select their region/language ~rr add 🇺🇸 @English ~rr add 🇪🇸 @Spanish ~rr add 🇫🇷 @French ~rr add 🇩🇪 @German ``` Connect members by location or language. ```bash theme={null} # Members request access to channels ~rr add ✅ @Verified ~rr add 🔞 @18+ ~rr add 🎓 @Student ``` Gate certain channels behind self-verification. *** ## Tips & Best Practices **Design Tips** * Use clear emoji that represent the role * Create organized embed panels with descriptions * Group similar roles together * Use color coding for visual clarity * Keep role names short and clear **Management Tips** * Regularly check `~rr list` to audit configurations * Test with an alt account before going live * Pin role selection messages for easy access * Document what each role does * Set up role colors to make roles visible **Common Issues** * **Bot can't assign role**: Check role hierarchy * **Reaction not working**: Verify bot has Add Reactions permission * **Role not assigning**: Bot needs Manage Roles permission * **Custom emoji not working**: Bot must be in server with that emoji *** ## Troubleshooting ### Role Not Being Assigned 1. Check bot has **Manage Roles** permission 2. Verify bot's role is **higher** than the role being assigned 3. Ensure the role isn't @everyone 4. Check bot can see the channel ### Reaction Not Adding 1. Verify bot has **Add Reactions** permission 2. For custom emojis, bot must be in a server with that emoji 3. Check the emoji still exists 4. Ensure message isn't in an archived thread ### "I Cannot Manage This Role" The role you're trying to assign is either: * Equal to bot's highest role * Higher than bot's highest role * **Solution:** Move bot's role higher in Server Settings → Roles *** ## Related Features Create and configure roles for reaction roles Create beautiful role selection panels Configure overall server settings Assign roles automatically when members join