Guides
Role menus
Let members pick their own roles with reactions or buttons. Colours, pings, games, verification. No code.
A role menu is a message where members pick roles themselves. They react to an emoji, or click a button, and get the role.
Good for:
- Colour roles
- Ping roles, like "Event pings" or "News"
- Game or region roles
- A "Verify" button that unlocks the server
What you need#
- The bot in your server, with the Manage Roles permission.
- The roles you want to give, already made in Server Settings → Roles.
- A channel for the menu, for example
#roles.
Most common problem
The bot can only give roles that are below its own role. Open Server Settings → Roles and drag the bot's role above every role in your menu.
Reactions or buttons?#
| Reaction roles | Button roles | |
|---|---|---|
| Members | React with an emoji | Click a button |
| Looks | Emojis under the message | Buttons with labels and colours |
| Modes | Give, take away | Toggle, add only, remove only, unique, verify |
| Best for | Quick menus | Clear labels, "pick only one" menus, verification |
Both are on the same page. You pick the type when you create the menu.
1. Start a new menu#
On the dashboard, open Reaction Roles, then press the create button. Pick Reaction roles or Button roles.
Fill in:
| Field | What to put |
|---|---|
| Name | A name only you see, for example Colour roles |
| Channel | Where the menu goes |
2. Write the message#
Under The message, pick one:
- Write a message. The bot posts a new message. Type the text in Message text.
- Use an existing message. Pick a message that is already in the channel. Reaction roles only.
Example text:
Pick your colour! React below.
❤️ Red 💙 Blue 💚 Green3a. Add reactions#
For Reaction roles, press Add your first reaction. For each row:
- Pick an emoji.
- In Gives, pick the roles the member gets.
- In Takes away, pick roles to remove (optional).
- Turn on Take the roles back when the reaction is removed if un-reacting should remove the role.
3b. Add buttons#
For Button roles, press Add button under Buttons. For each button:
- Type a Label, for example
Red team. - Pick a Colour and an emoji.
- Pick the Behaviour.
- Pick Roles to add and Roles to remove.
| Behaviour | What a click does |
|---|---|
| Toggle | Click to get the roles. Click again to lose them. |
| Add only | Click to get the roles. Clicking again does nothing. |
| Remove only | Click to lose the roles. |
| Unique | Members keep only one role from this message. |
| Verify | Gives the roles once. They are never taken away. |
4. Save#
Press the create button at the bottom. The bot posts the message and adds the reactions or buttons.
Later edits change the same message in Discord. Members keep the roles they have.
5. Test it#
Go to the channel and react or click. Check your roles in your profile.
Nothing happened? Check the warning at the top of this page. Then check the bot can see the channel.
Ideas#
- Verification gate. Make a
Verifiedrole. Hide your channels from@everyoneand show them toVerified. Add one Verify button. - One colour only. Use Unique, so picking Blue removes Red.
- Need logic? For example "only level 5+ can pick this". Build buttons with code instead. See Buttons and menus.