ReactionBot Setup Guide
Get ReactionBot running in your server in just a few minutes. This guide covers permissions, role hierarchy, dashboard modules, commands, and troubleshooting.
1. Invite ReactionBot
Click the Invite Link and select the server where you want to add ReactionBot. You will need Manage Server permission to invite bots.
2. Move the ReactionBot Role
Open Server Settings → Roles and drag the ReactionBot role above the roles it needs to manage.
Why this matters
Discord does not allow bots to manage roles that are higher than, or equal to, their own role. Even if ReactionBot has the correct permissions, Reaction Roles will not work unless the bot role is high enough.
3. Check Required Permissions
Make sure ReactionBot has these permissions at the server level and in any channel where you want it to work:
- View Channels
- Send Messages
- Manage Messages
- Manage Roles
- Read Message History
- Add Reactions
- Embed Links
Channel overrides can block the bot even when server permissions look correct. To check a channel, right-click it and open Edit Channel → Permissions.
4. Understand What ReactionBot Controls
ReactionBot manages emoji reactions added to messages. It does not remove or block normal emojis typed inside chat messages.
5. Dashboard Setup
The ReactionBot dashboard lets you manage major features visually without needing to memorize every command.
🎭 Reaction Roles
Create emoji-to-role mappings from the dashboard. Make sure ReactionBot has Manage Roles and its role is above the roles it assigns.
🧾 Bot Logger
Send reaction logs and daily analytics reports to a selected channel. Track moderation activity, top posts, server growth, voting, events, roles, and Influence activity.
🗳️ Reaction Voting
Create reaction-powered polls with live results, countdowns, and automatic winner announcements. ReactionBot needs access to the channel where polls are posted.
Open the dashboard here: reactionbot.gg/dashboard
6. Learn the Command System
Most commands use a Location option. Choose Channel (Free) to control reactions in a single channel, or Global (Premium) to apply rules across your entire server.
Example:
/allowonly → Location: Channel → Emojis: ❤️7. Run Your First Commands
Once setup is complete, try these commands in Discord.
💡 Most servers start with /block or /allowonly in a single channel.
Getting Started
/help— View command help/block— Block emoji reactions/unblock— Unblock emoji reactions/allowonly— Allow only specific reactions/listblocked— View blocked and allowed emojis/topreactor— Show top users for an emoji
Troubleshooting
/diagnose— Check permissions and setup/checkpremium— Check premium status/info— View bot information
8. Command Reference
Free Channel Controls
/help— View help and setup guidance/block— Block emoji(s) in this channel/unblock— Unblock emoji(s) in this channel/allowonly— Allow only specific emojis/clearallowonly— Clear allow-only/limitreaction— Set reaction limits/clearreactionlimit— Clear reaction limits/remove— Remove reactions/count— Count reactions/leaderboard— Top posts/topreactor— Top users for an emoji/info— View bot information/checkpremium— Check premium status/listblocked— View blocked and allowed emojis/diagnose— Check permissions and setup/purge— Delete messages
Premium Server-Wide Controls
/block+Global— Block emojis server-wide/unblock+Global— Unblock emojis server-wide/allowonly+Global— Server-wide allow-only/clearallowonly+Global— Clear server-wide allow-only/limitreaction+Global— Set server-wide limits/clearreactionlimit+Global— Clear server-wide limits/remove+Global— Remove reactions across the server/count+Global— Count reactions across the server/leaderboard+Global— Top posts across the server/topreactor+Global— Top users across the server/redeem XXXX-XXXX-XXXX— Activate premium
9. Premium Features
Premium unlocks server-wide control and advanced analytics, letting you apply reaction rules across your entire server and receive daily insight reports about your community.
📊 Premium Logger Analytics
- ✔ Daily Summary Reports
- ✔ Top Posts and reaction insights
- ✔ Server Growth Reports
- ✔ Roles, Events, Voting, and Influence reports
- ✔ Scheduled report delivery through the dashboard
To activate premium, use:
/redeem XXXX-XXXX-XXXX10. Common Issues
Reaction Roles are not assigning
Make sure ReactionBot has Manage Roles and that the ReactionBot role is above the role it is trying to assign.
Dashboard cannot load servers
Log in with Discord first. ReactionBot can only show servers where your Discord account has the required permissions.
ReactionBot cannot remove reactions
Check that ReactionBot has Manage Messages, Read Message History, and access to the channel where the reaction was added.
11. Need Help?
If something is not working, run /diagnose first. It will quickly show whether ReactionBot is missing permissions or has a setup issue.
You can also join the ReactionBot Hub Discord Server or visit the Support Page.