Discord reaction role template

Let members choose a role through a specific reaction.

Listen for a configured emoji on the intended message, map the reaction to a role, and keep the assignment path visible in the BotFrame workflow.

Build this workflow Follow the guide

Workflow blueprint

Reaction added→Match message and emoji→Reaction role→Optional confirmation

The trigger supplies the reacting member, message, channel, and emoji. Conditions keep unrelated reactions out of the path, while the role action performs only the configured assignment.

Configure the reaction safely

Publish one stable role-selection message and record its Discord message ID.
Use the exact Unicode or custom emoji representation expected by the trigger.
Select a non-administrative role and review its channel access.
Ensure the bot role is high enough to manage the target role.
Test an unrelated message, the wrong emoji, and a valid role selection.

Nodes used

TriggerReaction added

Starts with the message, emoji, and current member context.

LogicCheck a condition

Filters for the intended message and reaction value.

Server actionReaction role

Applies the configured role behavior for the matched reaction.

OptionalSend direct message

Confirms the member's selection without adding noise to the role channel.

When to use buttons instead

Reactions are familiar and compact, but buttons or select menus can provide clearer labels and a more explicit interaction ID. For a verification flow or a large role catalog, compare this template with the verification bot template.

Create the role selection

Use the reaction-role guide and test the exact message, emoji, and role mapping.