Role ReactorSetup Guide
Complete setup guide for Role Reactor Bot - from installation to creating your first role messages
Quick Start
Invite the Bot
Add Role Reactor Bot to your server
Make sure to grant these permissions:
- Manage Roles
- Send Messages
- Use Slash Commands
- Add Reactions
Create Your First Role Message
/setup-roles title:"Server Roles"
description:"Choose your roles below!"
roles:"š®:Gaming,š:Books,šµ:Music"Test It Works
Click the reactions on your new role message to make sure roles are assigned correctly.
That's it! You now have a working role system. Continue reading for advanced configuration options.
Bot Permissions
Required Permissions
The bot needs these permissions to function:
Manage Roles
Assign and remove roles from members
Send Messages
Create role selection messages
Use Slash Commands
Access to /role commands
Add Reactions
Add emoji reactions to messages
Permission Setup
- During Invite: Select all required permissions when inviting the bot
- After Invite: Check bot permissions in Server Settings > Roles
- Role Position: Make sure the bot's role is above any roles it manages
Important: The bot can only manage roles that are positioned below its own role in the server hierarchy.
Creating Role Messages
Basic Role Message
Basic role list:
/setup-roles
title:"Choose Your Roles"
description:"React to get roles!"
roles:"š®:Gaming,š:Reading,šµ:Music,šØ:Art"Results in:
Choose Your Roles
React to get roles!
š® š šµ šØOrganized with categories:
2. Create role categories:/setup-roles title:"Game Roles" description:"Choose your favorite games!" roles:"š“:Valorant,ā”:Apex Legends,āļø:League of Legends"
Results in:
Server Roles
Pick your interests!
āāāāāāā Hobbies āāāāāāā
š® š
āāāāāāā Notifications āāāāāāā
š¢ šFull customization:
/setup-roles
title:"š Community Roles"
description:"**Welcome!** Choose your roles below.\n\n*You can select multiple roles.*"
roles:"#Gaming š®\nš„ļø:PC Gaming,š®:Console,š±:Mobile\n#Creative šØ\nšØ:Art,šø:Photo,šµ:Music"
color:"#7289DA"Role Categories
Organize roles with categories for better user experience:
Category Header
Start with #Category Name to create a section header
Add Roles
List roles under each category: emoji role1,emoji role2
Multiple Categories
Separate categories with \n for new lines
Example Structure:
#Gaming Platforms
š„ļø:PC Gaming,š®:Console Gaming,š±:Mobile Gaming
#Notifications
š¢:Announcements,š:Events,š°:News
#Interests
šØ:Art,š:Books,šµ:MusicRole Management
Managing Existing Messages
Edit Message
/update-roles - Update title, description, or roles
Delete Message
/delete-roles - Remove a role message
List Messages
/list-roles - See all your role messages
Refresh Reactions
Contact support - Fix broken reactions
Role Colors and Customization
Setting Role Colors:
/role create name:"Gaming" color:"#FF0000" emoji:"š®"
/role create name:"Music" color:"#00FF00" emoji:"šµ"Color Guidelines:
- Use hex colors (#FF0000) for precise control
- Keep related roles in similar color families
- Avoid colors that are hard to read
- Consider colorblind accessibility
Server Organization
Channel Setup
Recommended Channel Structure:
š INFORMATION
āāā š rules
āāā š¢ announcements
āāā š get-roles
š¬ GENERAL
āāā š¬ general-chat
āāā š® gaming
āāā šµ musicRole Channel Best Practices
Create a dedicated #get-roles channel for the best user experience
Channel Setup:
- Create a channel named
#get-rolesor#roles - Set proper permissions (everyone can see, limited sending)
- Pin important role messages
- Add channel description explaining how to use reactions
Channel Description Example:
š Role Selection
React to the messages below to get roles!
ā¢ Click an emoji to get that role
ā¢ Click again to remove the role
ā¢ You can have multiple roles
ā¢ Ask in #general if you need helpAdvanced Configuration
Role Hierarchy
Important Rules:
- Bot's role must be above managed roles
- Higher roles in the list have more permissions
- Be careful with administrative roles
Setting Up Hierarchy:
- Go to Server Settings > Roles
- Drag the bot's role above any roles it should manage
- Arrange other roles by importance
- Test role assignment to verify it works
Multiple Role Messages
For larger servers, create multiple focused role messages:
Message 1: Essential Roles
/setup-roles title:"Essential Roles"
roles:"š¢:Announcements,š:Events,š¬:General Chat"Message 2: Interests
/setup-roles title:"Your Interests"
roles:"#Hobbies\nš®:Gaming,š:Reading,šµ:Music,šØ:Art"Message 1: Gaming Platforms
roles:"š„ļø:PC,š®:PlayStation,š®:Xbox,š±:Mobile,š¹ļø:Nintendo"Message 2: Game Types
roles:"#Genres\nš«:FPS,āļø:RPG,šļø:Racing,š²:Strategy,š„:MMO"Message 3: Activity
roles:"#Playstyle\nš:Competitive,šÆ:Casual,š„:Looking for Group"Message 1: Subjects
roles:"#Subjects\nš:Math,š¬:Science,š:English,šļø:History"Message 2: Study Groups
roles:"#Study Style\nš„:Group Study,š¤«:Solo Study,š
:Study Schedule"Troubleshooting Setup
Common Issues
Bot Not Responding
- Check bot permissions
- Verify bot role position
- Make sure bot is online
Roles Not Being Given
- Check role hierarchy (bot role above target roles)
- Verify role names match exactly
- Test with a simple role first
Reactions Not Working
- Contact support to fix reactions
- Check if emojis are from the server or Unicode
- Verify bot can add reactions in the channel
Getting Help
If you're still having issues:
- Check the Troubleshooting section for detailed solutions
- Join our support server for community help
- Report bugs through our GitHub issues page
Setup Complete! Your Role Reactor Bot is now ready to use. Check out the Examples section for inspiration on creating engaging role systems for your community.
Adding the Bot
Learn how to add Role Reactor Bot to your Discord server and set it up for role management.
Setup Roles
Use this command to let members assign themselves roles by reacting to a message. Ideal for community, gaming, or study servers where users can opt into interests, notifications, or access levels.