Role Reactor LogoRole Reactor

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

  1. Go to Server Settings > Roles
  2. Drag the bot's role above all roles you want it to manage
  3. 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"