ReactionBot Logo

ReactionBot Setup Guide

Get ReactionBot running in your server in just a few minutes. This guide covers setup, permissions, first commands, and the new slash-command system.

New: ReactionBot now uses slash commands with a Location option for Channel or Global actions. This replaces older global commands and makes setup much easier.

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 Role Above Members

Open Server Settings → Roles and drag the ReactionBot role above member roles.

This step is very important. If ReactionBot’s role is below other users, it may have the right permissions but still be unable to remove reactions.

3. Check Required Permissions

Make sure ReactionBot has these permissions at the server level and in every channel you want it to manage:

  • Send Messages
  • Manage Messages
  • Read Message History
  • 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 in chat messages.

5. Learn the New Command System

Most commands now use a Location option. This lets you choose whether a rule applies to the current Channel or the entire server as Global.

Example:

/block → Location: Channel → Emojis: 😂

This new system replaces older global commands and keeps everything simpler and easier to use.

6. Run Your First Commands

Once setup is complete, try these commands in Discord:

Getting Started

  • /help — View setup instructions and command help
  • /block — Block emoji(s) in this channel
  • /unblock — Unblock emoji(s)
  • /listblocked — View blocked and allowed emojis

Troubleshooting

  • /diagnose — Check permissions and setup
  • /checkpremium — Check premium status
  • /info — View bot information

7. Command Reference

Here are the main commands available in ReactionBot.

Free Commands

  • /help — View help and setup guidance
  • /block — Block emoji(s) in this channel
  • /unblock — Unblock emoji(s) in this channel
  • /info — View bot information
  • /checkpremium — Check premium status
  • /listblocked — View blocked and allowed emojis
  • /diagnose — Check permissions and setup
  • /count — Count total reactions for an emoji in this channel
  • /leaderboard — Count total reactions for an emoji in this channel
  • /purge — Delete messages

Premium Features

  • /block + Location: Global
  • /unblock + Location: Global
  • /allowonly — Restrict allowed emojis
  • /clearallowonly — Clear restrictions
  • /limitreaction — Set reaction limits
  • /clearreactionlimit — Clear reaction limits
  • /remove — Remove reactions from messages
  • /count + Location: Global
  • /leaderboard + Location: Global
  • /redeem XXXX-XXXX-XXXX — Activate premium

8. Premium Features

Premium unlocks global controls, multi-emoji actions, allow-only lists, reaction limits, and more advanced moderation tools.

To activate premium, use:

/redeem XXXX-XXXX-XXXX

9. 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.