Reaction Roles

Members react to a message with an emoji and Phantom grants them a role.

Where it lives

Dashboard: Community → Reaction Roles. Each panel is a (message_id, emoji-to-role mapping, mode) record.

Modes

• Add — reaction grants the role; un-reacting removes it.
• Remove — reacting strips the role.
• Toggle — first reaction grants, second strips, third grants, etc.

Each panel is one mode.

Setting up

1. Post a message in your channel (manually or via Embed Builder).
2. Copy the message ID (Developer Mode → right-click → Copy ID).
3. On the Reaction Roles dashboard, click Add panel, paste the ID.
4. Add emoji ↔ role pairs.
5. Save. Phantom auto-applies the reactions to the message so members can click them.

Tips

• Use one panel for self-assignable roles (pronouns, region, notification opt-ins).
• Use separate panels per group so you can change modes (add vs toggle) per group.
• Don't use this for security-related roles — reaction-roles are easily granted by bots; pair with Verification first.
• Make sure Phantom's role is above the granted roles in the hierarchy.

Limits

• Reactions per panel: limited by Discord (20 unique reactions per message).
• Panels per guild: no hard cap.

Permissions

• community.view — see panels
• community.edit — add / edit / delete

Related pages

• Join Roles
• Verification
• Embed Builder