Skip to main content

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.

​
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.
~reactionrole add <message_link> <emoji> <@role>
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.
~reactionrole remove <message_link> <emoji>
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.
~reactionrole removeall <message_link>
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.
~reactionrole 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.
~reactionrole 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

1

Create a Role Selection Message

Create an embed or message explaining the roles:
~embed create {embed}
$v{title: Select Your Roles}
$v{description: React to get roles!
🎮 - Gamer
🎨 - Artist
📚 - Reader}
{embed}
2

Add Reaction Roles

Add reaction roles to the message:
~rr add <message_link> 🎮 @Gamer
~rr add <message_link> 🎨 @Artist
~rr add <message_link> 📚 @Reader
3

Members React

Members click reactions to get roles:
  • Click emoji = get role
  • Unclick emoji = lose role
  • Works instantly

​
Permission Requirements

Bot Permissions

The bot needs:
  • Manage Roles
  • Add Reactions
  • Read Messages
  • View Channel (for the reaction message)

User Permissions

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

reactionrole

Full command

rr

Short alias

reactionroles

Alternative

​
Usage Examples

# 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 <link> 🎮 @Gamer
~rr add <link> 🎨 @Artist
~rr add <link> 📚 @Reader

# 4. Members can now react!

​
Common Use Cases

# Members choose their name color
~rr add <link> 🔴 @Red
~rr add <link> 🟠 @Orange
~rr add <link> 🟡 @Yellow
~rr add <link> 🟢 @Green
~rr add <link> 🔵 @Blue
~rr add <link> 🟣 @Purple
Let members customize their appearance.
# Members control what they're pinged for
~rr add <link> 📢 @Announcements
~rr add <link> 🎉 @Events
~rr add <link> 🎁 @Giveaways
Reduce unwanted pings, increase engagement.
# Members show what they play/like
~rr add <link> 🎮 @Valorant
~rr add <link> ⚔️ @Minecraft
~rr add <link> 🎨 @Artist
~rr add <link> 💻 @Developer
Help members find others with shared interests.
# Members select their region/language
~rr add <link> 🇺🇸 @English
~rr add <link> 🇪🇸 @Spanish
~rr add <link> 🇫🇷 @French
~rr add <link> 🇩🇪 @German
Connect members by location or language.
# Members request access to channels
~rr add <link> ✅ @Verified
~rr add <link> 🔞 @18+
~rr add <link> 🎓 @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

Role Management

Create and configure roles for reaction roles

Embed Builder

Create beautiful role selection panels

Server Settings

Configure overall server settings

Autorole

Assign roles automatically when members join