Reaction roles
Post a panel where members pick their own roles with buttons, a dropdown or emoji reactions.
Updated
·
By Mike
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
- In Server Settings, then Roles, move the bot's role above every role members can pick.
- Open Greetings, then Reaction roles on the dashboard, or run /reactionrole create in Discord.
- 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.