Common Issues
These are the most frequent problems users encounter with Role Reactor Bot and how to solve them.
Bot Not Responding
Check Bot Status
- Is the bot online?
- Try
/ping
to test if bot responds
Verify Permissions
- Bot needs "Send Messages" and "Use Slash Commands"
- Check channel-specific permissions
Check Role Position
- Bot's role must be above roles it manages
- Go to Server Settings > Roles to check hierarchy
Roles Not Being Assigned
Most Common Cause: Bot's role is positioned below the roles it's trying to assign
Fix Role Hierarchy
- Go to Server Settings > Roles
- Drag the bot's role above all roles you want it to manage
- Test role assignment again
Check Role Names
- Make sure role names in the command match exactly
- Role names are case-sensitive
Verify Bot Permissions
- Bot needs "Manage Roles" permission
Command Errors
See the Troubleshooting Guide for a full list of error messages and solutions.
Reactions Missing
Use Unicode Emojis
- Custom server emojis might not work in all situations
- Stick to standard Unicode emojis for best results
Check Bot Permissions
- Bot needs "Add Reactions" and "Manage Messages"