ReactionBot Documentation

Missing Permissions

Learn how to identify and resolve Discord permission problems affecting ReactionBot.

Most ReactionBot issues are caused by missing Discord permissions or incorrect role hierarchy. This guide explains how to identify and fix those problems.

Common Symptoms

Commands complete but reactions remain on messages.

Logger does not post.

Dashboard rules appear enabled but have no effect.

ReactionBot responds in some channels but not others.

Required Permissions

Review the Permissions guide to verify every required Discord permission has been granted.

Pay particular attention to Manage Messages, Read Message History, Embed Links, and View Channels.

Role Hierarchy

ReactionBot's role must be above the roles of members it moderates.

Discord prevents bots from moderating members whose highest role is above the bot.

Channel Overrides

Individual channel permissions override server-wide permissions.

Always check channel overrides when only one channel is affected.

Run /diagnose

Use /diagnose to quickly identify missing permissions and common configuration problems.

Correct any reported issues before testing the feature again.

After Fixing Permissions

Test the affected command or feature again.

Most permission changes take effect immediately without restarting the bot.