> ## Documentation Index
> Fetch the complete documentation index at: https://docs.criminal.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Reaction Roles

> Bind roles to reactions or buttons · bindings survive restarts and message reloads.

A binding is saved against the message and emoji, so a restart never breaks a panel.

## Commands

| Command | What it does |
| - | - |
| `/reactionrole add <message> <role> <emoji> [mode]` | Bind a role to an emoji on a message |
| `/reactionrole remove <message> <emoji>` | Remove a binding |
| `/reactionrole list` | Show every binding in this server |

`<message>` accepts a message ID or a message link, and if you reply to a message the bot binds to
the replied-to message instead.

## Toggle or add-only

The `mode` decides what un-reacting does:

| Mode | Behaviour | Use it for |
| - | - | - |
| `toggle` | Reacting grants, un-reacting removes | Self-assignable interest roles |
| `add` | Reacting grants and un-reacting does nothing | Verification · members can't accidentally lose access |

```text theme={null}
/reactionrole add message:123456789 role:@Verified emoji:✅ mode:add
```

## Prefix

```text theme={null}
,rr add <message ID or link> <role> <emoji> [toggle|add]
,rr remove <message ID or link> <emoji>
,r <member> <role>
```

The older `,rr <message> <role> <emoji>` shorthand still works. Removing a binding leaves the visible
reaction on the message · it simply stops granting anything.

## Buttons instead of reactions

`/embed` can add **role buttons** to a message. Buttons are cleaner than emoji for a verification
gate and don't show a reaction counter. Use them when you're building a public "click to get access"
panel; use reactions when members should be able to toggle interests.

**Give the bot Manage Roles**

A binding only works if the role sits below Criminal's highest role. Test one role before building
a ten-role panel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.