> For the complete documentation index, see [llms.txt](https://miulien.gitbook.io/bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://miulien.gitbook.io/bot/en/utilities/reactionrole.md).

# Reaction Roles (reactionrole)

Run `/reactionrole` to map an **emoji reaction** on a Discord message to a role. Members can claim a role by reacting and remove a role obtained through this feature by removing the reaction. They do not need moderation permissions.

## Add a binding

1. Run `/reactionrole` and select **Add Binding**.
2. Choose the role to grant.
3. Enter a **message link from the current server**, plus an emoji (Unicode or an available custom emoji).
4. Miulien verifies that the message is accessible, reactions can be added, and the role is manageable before saving.

Each server supports up to **50 bindings**. A role cannot be bound more than once, nor can the same emoji on the same message be bound more than once.

## Claiming and removing roles

* **React:** Miulien attempts to assign the role if the member does not already have it.
* **Remove reaction:** Miulien attempts to remove the role if the member originally received it through this feature.
* **Already held:** A preexisting role is not reassigned, and removing the reaction does not remove roles granted outside this feature.

> If a member originally received a role through a reaction and an administrator later adjusts the same role manually, removing the reaction may still remove it.

## Management panel

* **Add Binding:** Create a message–emoji–role mapping.
* **Delete Binding:** Delete a selected mapping after confirmation. **Already assigned roles are not automatically removed.**
* **Synchronize:** Compare message reactions with stored role status and fix differences.
* **Previous / Next / Refresh:** Browse and update the panel.

**Tracked subscriptions** counts recorded member–role relationships; **Subscribers** counts distinct tracked members. Members with a preexisting role may not be counted.

## Original messages and synchronization

You may edit a source message's **text or embed** freely without updating the binding. If you delete and repost it, you must bind the new message. Miulien attempts to reconcile role state after coming back online, and moderators can run **Synchronize** at any time.

## Permissions and limits

* **Manage bindings:** Requires **Manage Roles** or an additional `reactionrole` authorization via `/permissions`.
* **Members using reactions:** No moderation permission required.
* Miulien requires **Manage Roles**, and the target role must be below Miulien's highest role.
* Non-owners can only manage roles below their own highest role, even with an extra `/permissions` grant.
* Server owners are exempt from their personal hierarchy limit. `@everyone` and integration-managed roles cannot be bound.

See also [Role Management](/bot/en/utilities/role.md).
