ReactionBot Documentation

Reaction Roles

Automatically assign, remove, and verify Discord roles using emoji reactions and advanced role rules.

Reaction Roles allows members to assign themselves Discord roles simply by reacting to a message. From simple role menus to advanced verification flows, ReactionBot gives you complete control over how members gain access to your community.

What Are Reaction Roles?

Reaction Roles connect an emoji to a Discord role. When a member reacts to a configured message, ReactionBot automatically assigns the linked role.

If enabled, removing the reaction can also remove the assigned role.

What Can Roles Do?

ReactionBot supports standard reaction roles, multi-role menus, verification flows, role requirements, automatic role removal, role logging, and advanced role management.

Whether you're building a gaming server, creator community, or support server, Roles can automate member onboarding without requiring moderator involvement.

Features Included

• Reaction Role Mappings

• Single and Multi Role Modes

• Verification Flows

• Required Roles

• Remove Existing Roles

• Role Logging

• Grouped Role Menus

• Premium Role Features

How It Works

Create a role mapping from the ReactionBot dashboard by selecting a channel, message, emoji, and Discord role.

Once saved, ReactionBot watches that message and automatically manages member roles whenever reactions are added or removed.

Free vs Premium

Free servers can create a limited number of role mappings.

ReactionBot Premium unlocks additional mappings, advanced verification flows, and expanded role management capabilities.

Before You Begin

ReactionBot must have the Manage Roles permission.

Its highest role must also be positioned above every role it needs to assign.

Without proper role hierarchy, Discord will prevent ReactionBot from managing roles regardless of its permissions.

Next Steps

Continue through the Roles documentation to learn how to create reaction role mappings, configure verification flows, build grouped role menus, and troubleshoot common setup issues.