# Reaction roles

Post a panel where members pick their own roles with buttons, a dropdown or emoji reactions.

Source: https://noxyrbot.com/docs/reaction-roles

## How it works

A role panel is one message in a channel you pick. Members use it to give themselves a role, and use it again to take the role back. Nobody on your staff has to do anything.

Each panel holds up to 20 roles, and a server can have up to 20 panels. Turn on One role only when members should hold just one role from the panel, such as a region or a colour: picking a new role then removes the old one.

## Three ways to pick

- **Buttons**: One button per role, with a label, an emoji or both. Members get a private reply saying what changed.
- **Dropdown**: One menu with every role. Best for long lists. Picking a role again takes it back.
- **Reactions**: The classic style: the bot adds one emoji per role under the message, members click one, and removing the reaction takes the role back. Every role needs its own emoji.

## Set it up

1. In Server Settings, then Roles, move the bot's role above every role members can pick.
2. Open Greetings, then Reaction roles on the dashboard, or run /reactionrole create in Discord.
3. Pick the style and channel, add your roles, and post. Saving a change later updates the live message.

## Commands

- **/reactionrole create style:<style> role:<role>**: Post a new panel with its first role. Options: emoji, label, channel, title, message, single.
- **/reactionrole add panel:<panel> role:<role>**: Add a role to a panel. The live message updates.
- **/reactionrole remove panel:<panel> role:<role>**: Take a role off a panel. Members who have it keep it.
- **/reactionrole delete panel:<panel>**: Delete a panel and its message. Members keep their roles.
- **/reactionrole list**: Every role panel in the server.

## Good to know

- **Who can set it up**: Members with Manage Roles can use /reactionrole. The dashboard page is for server admins.
- **Roles that are refused**: Any role with a moderation permission, such as Administrator, Ban Members or Manage Messages, because members would be giving it to themselves. Noxyr checks again every time someone picks a role, so a role that gains one of these later stops being handed out.
- **Permissions the bot needs**: Manage Roles, plus View Channel, Send Messages and Embed Links in the panel's channel. Reaction panels also need Add Reactions and Read Message History.
- **Custom emojis**: Must be uploaded to your own server, so the bot can always use them. Normal emojis work everywhere.
- **Custom bots**: Reaction roles work on a Noxyr custom bot too. If you switch bots, save the panel again so the bot that runs your server posts it.

## Frequently asked questions

**What are reaction roles on Discord?**

A panel where members give themselves a role by clicking a button, a dropdown option or an emoji reaction. Doing it again takes the role back. Noxyr supports all three styles.

**How do I make members lose a role when they remove their reaction?**

That is how reaction panels work by default. When a member removes their reaction, Noxyr takes the role away. On button and dropdown panels, picking the same role again takes it back.

**Can members hold only one role from a panel?**

Yes. Turn on One role only on the dashboard, or set single to true in /reactionrole create. Picking a new role then removes the member's other role from that panel.

**Why can't I pick a role on the dashboard?**

The list leaves out roles the bot cannot give: roles above the bot's own role, roles managed by an integration, and roles with moderation permissions. Move the bot's role higher in Server Settings, then reload the page.

**Why did a member not get the role?**

Check that the bot's role is above that role and that it has Manage Roles. If a role was given a moderation permission after the panel was made, Noxyr stops handing it out until you remove that permission or pick another role.