Role ReactorFirst Steps
Get started with Role Reactor Bot by creating your first role message and understanding how it works.
šÆ Quick Start Example
Let's create a simple role message that your members can use right away.
Choose Your Roles
First, decide what roles you want members to be able to assign themselves. For this example, we'll use:
- š® Gamer - For gaming enthusiasts
- šØ Artist - For creative members
- š» Developer - For tech-minded people
Make sure these roles exist in your server before creating the role message! Go to Server Settings > Roles to create them if needed.
Create the Role Message
In any channel where you want the role message to appear, type:
/setup-roles title:"Choose Your Roles" description:"React below to assign yourself roles!" roles:"š®:Gamer,šØ:Artist,š»:Developer"What this does:
- Creates a message titled "Choose Your Roles"
- Adds a description explaining what to do
- Sets up 3 emoji-role pairs (š® for Gamer, šØ for Artist, š» for Developer)
Test It Out!
- Look for the new message that appeared
- Click the š® reaction - you should get the "Gamer" role
- Check your role list in the member sidebar
- Remove the reaction to remove the role
It worked! Your members can now self-assign roles by reacting to your message!
šØ Making It Look Better
Let's improve the appearance with a custom color and better description:
/setup-roles title:"š Community Roles" description:"**Welcome to our server!**\n\nChoose roles that match your interests:\n\nā¢ š® Gaming enthusiasts\nā¢ šØ Creative minds\nā¢ š» Tech lovers" roles:"š®:Gamer,šØ:Artist,š»:Developer" color:"#7289DA"š Community Roles
Welcome to our server!
Choose roles that match your interests:
ā¢ š® Gaming enthusiasts
ā¢ šØ Creative minds
ā¢ š» Tech lovers
š® šØ š»New features used:
- Custom color (
#7289DA- Discord's blue) - Bold text with
**bold** - Line breaks with
\n - Bullet points with
ā¢
š± Understanding the Results
When you create a role message, here's what your members will see:
How Members Use It
- See the message in the channel
- Read the description to understand what each emoji means
- Click emoji reactions to get roles
- Remove reactions to remove roles
- Check their profile to see new roles
šļø Organizing with Categories
For servers with many roles, organize them into categories:
/setup-roles title:"Server Roles" description:"Choose your roles by category!" roles:"#Gaming\nš®:Gamer,š²:Board Games,š¹ļø:Retro Gaming\n#Creative\nšØ:Artist,šø:Photographer,āļø:Writer" color:"#43AA8B"Server Roles
Choose your roles by category!
āāāāāāā Gaming āāāāāāā
š® Gaming enthusiasts
š² Board game lovers
š¹ļø Retro gaming fans
āāāāāāā Creative āāāāāāā
šØ Artists and designers
šø Photography enthusiasts
āļø Writers and storytellers
š® š² š¹ļø šØ šø āļøš§ Quick Troubleshooting
Common Issues
"The bot didn't respond to my command"
- Make sure the bot has permission to send messages in that channel
- Check that you typed the command correctly (start with
/setup-roles)
"Members can't get roles when they react"
- Verify the role names match exactly (case-sensitive)
- Check that the bot's role is above the roles it's trying to assign
- Ensure the bot has "Manage Roles" permission
"The emoji reactions didn't appear"
- The bot needs "Add Reactions" permission
- Custom emojis might not be available to the bot
Quick Fixes
- Check bot permissions in channel settings
- Verify role hierarchy in Server Settings > Roles
- Test with simple role names (avoid special characters)
Next Steps:
- Check out Example Setups for your server type