> For the complete documentation index, see [llms.txt](https://docs.asagi.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.asagi.xyz/members-and-roles/reaction-roles.md).

# Reaction Roles

Reaction Roles lets members manage roles by reacting to messages created through the Asagi dashboard.

Everything on this page is configured from **Dashboard → Members & Roles → Reaction Roles**.

### Create a Reaction Role Message

1. Open **Reaction Roles**.
2. Select **New reaction role**.
3. Give the setup a title so you can recognize it in the dashboard.
4. Choose the Discord channel where the message should be sent.
5. Create a custom message or select one of your saved Embed Messages templates.
6. Choose the **Message Mode**.
7. Add at least one reaction under **Assigned roles** or **Taken roles**.
8. Choose an emoji and one or more roles for every reaction.
9. Select **Save and close**.

> 🎬 **Create a Reaction Role message**
>
> See how to create a message, connect reactions to roles, and publish it in Discord.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2F6hlT5fQkyqHUZZqFleBF%2Freaction%20roles%20setup.mp4?alt=media&token=d3af7eee-0106-47dc-99ac-4a1e30b0b6c1>" %}

> 🖼️ **Reaction Role message in Discord**
>
> Members use the reactions below the message to manage their roles.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FtIz9vHma7JkU7XBXQBac%2Freaction%20roles%20discord%20message.webp?alt=media&amp;token=79f6a820-9dfa-420b-8fdb-12b5d221746a" alt=""><figcaption></figcaption></figure>

### Channel and Message

Reaction Role messages can be sent to a **text channel** or **announcement channel**. You can also create a new channel from the channel selector if you need one.

For the message itself, choose one of two sources:

* **Custom** — build the message directly in the editor;
* **My Templates** — reuse one of your saved Embed Messages templates.

When an existing Reaction Role setup is edited, Asagi synchronizes the message and configured reactions with the existing Discord message.

### Message Mode

Reaction Roles supports two modes.

#### Single Role per Message

Use **Single role per message** when members should only keep one choice from that Reaction Role message.

When a member adds a configured reaction, Asagi removes their other reactions from the same message and removes roles assigned by those other configured reactions before applying the new choice.

Because Asagi removes reactions in this mode, it also needs the **Manage Messages** permission.

#### Multiple Roles per Message

Use **Multiple roles per message** when members should be able to choose several reactions independently.

Each configured reaction works on its own, so members can keep roles from multiple reactions on the same message.

### Assigned Roles

Use **Assigned roles** when reacting should give one or more roles to the member.

For each reaction:

1. select an emoji;
2. select one or more roles to assign.

When the member removes that reaction, Asagi removes the roles configured under **Assigned roles** for it.

### Taken Roles

Use **Taken roles** when reacting should remove one or more roles from the member.

This is useful when a reaction represents opting out of an existing role.

> **Important:** removing a Taken Roles reaction does not restore the roles that were removed. The removal happens when the reaction is added.

### Emoji Rules

Each emoji can only be used once inside the same Reaction Role setup, including across **Assigned roles** and **Taken roles**.

You can use standard emoji or custom emoji available in the editor. If an emoji is already used by another reaction in the same setup, the dashboard prevents it from being selected again.

### Quick Start

Reaction Roles includes ready-to-use Quick Start presets for common setups:

* **Verify** — a simple rule-confirmation flow;
* **Colors** — let members choose a color role;
* **Region** — let members choose a region role.

A preset gives you a starting configuration that you can review and customize before saving.

> 🖼️ **Quick Start presets**
>
> Start with a ready-made setup and customize the reactions and roles for your server.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FIVEl1vvomuV9or6lWnAs%2Freaction%20roles%20quick%20sets.webp?alt=media&amp;token=0d2aa5ba-929f-4326-a25e-9928d4591f96" alt=""><figcaption></figcaption></figure>

### Limits

The available limits depend on whether the server has Premium.

| Limit                  | Free | Premium |
| ---------------------- | ---: | ------: |
| Reaction Role messages |    5 |      50 |
| Reactions per message  |    5 |      20 |

The reaction limit counts entries across **Assigned roles** and **Taken roles** together.

### Edit or Delete a Reaction Role Message

Your existing setups appear under **Your Reaction Roles**.

From there you can:

* search your Reaction Role messages;
* open a setup and change its message, mode, reactions, or roles;
* delete a setup you no longer need.

When reaction settings are changed, Asagi synchronizes the reactions on the Discord message. When a setup is deleted, Asagi also attempts to delete its Discord message.

### Permissions and Role Hierarchy

For role changes to work, Asagi needs **Manage Roles**, and the Asagi role must be above every role it needs to assign or remove.

The dashboard filters role selections according to Discord role hierarchy and access rules. If the hierarchy changes later and a configured role becomes unavailable to Asagi, the reaction can remain visible while the role action fails.

For **Single role per message**, Asagi also needs **Manage Messages** so it can remove a member's other reactions from the message.

If a Reaction Role action cannot be completed, Asagi can surface the problem through dashboard notifications.

### Where to Go Next

Continue with [**In-voice Temporary Roles**](/members-and-roles/in-voice-temporary-roles.md) to automatically manage roles while members are connected to selected voice channels or categories.