How to make reaction roles on Discord
Discord has no reaction roles of its own, so a bot posts the menu and hands out the roles. Here's how to set one up for free, put it on a new or old message, and fix it when pressing does nothing.
Reaction roles let members give themselves a role by pressing something: a colour, a game they play, a ping they want. Discord can't do this by itself, so a bot posts the menu and hands out the roles. This guide uses BotGhost's Reaction Roles module, which is free, and ends with the one way to do something similar without a bot.
You need a bot in your server first. The no-code bot guide makes one in about five minutes, and you need the roles themselves made in Server Settings. Our guide to adding roles in Discord covers that part.
1Pick buttons, a dropdown, or reactions
- Buttons are one press, and the bot replies to that member privately so they know what changed. Best for a handful of roles.
- A dropdown fits a long list, like every game your server plays, and members can pick several at once.
- Reactions are the classic version. Everyone sees how many people picked each role, and it's the only style that can go on a message you already posted, like your rules.
2Set up the menu
Switch on Reaction Roles
In your bot's dashboard, open Reaction Roles and switch it on. Start from a template like Colours if one fits, or from a blank menu. Pick how members choose on How members pick.
Add the roles
Add a row for each role, with the words on its button or option, an emoji, and a button colour. The module uses roles you already made; it never creates any. A menu holds up to 20 roles.
Each role can do more than give itself. Also gives hands out a second role with it, Takes away removes one, Needs first keeps it for people who already have a role, and At most caps how many members can have it.
Decide what a pick does
This is the setting people miss. Each menu works one of five ways:
- Get and take off: press once to get the role, again to lose it. The usual choice.
- Only one: picking a new role swaps out the old one. Right for colours and teams.
- Only give: members can get roles from the menu but not remove them.
- Pick once: one pick, for good. Good for a team draft.
- Only take: the menu only removes roles, for an opt-out list.
Take roles away after a time removes the role by itself after up to 90 days, which suits event passes and trial roles.
Limits and who can use it
To keep alts and raiders out, set roles a member needs (or must not have), a minimum account or server age, a wait between picks, and a time the menu closes.
3Post the menu
As a new message
On Look and post, write the message above the buttons with Edit message, pick the channel, and press Post it. You can also post it from Discord with /reactionroles post, which needs Manage Roles.
On a message you already have
For a reactions menu, right click the message in Discord, press Copy Message Link, and run /reactionroles attach with that link and the menu. The bot adds the reactions to your message. Buttons and dropdowns can't do this, because Discord only lets a bot put buttons on its own messages.
4Test it and fix the role order
Press a button or react with an account that isn't the server owner. If nothing happens, it's almost always the role order:
- Open Server Settings, then Roles.
- Drag your bot's role above every role in the menu.
- Check the bot's role has Manage Roles.
The dashboard warns you. If a role in a menu sits above the bot's role, the Reaction Roles page says so, and the bot tells the member when it can't give a role instead of failing quietly.
5Without a bot: Discord Onboarding
If your server has Community turned on, Discord's own Onboarding (in Server Settings) asks new members questions when they join, and each answer can give roles and open channels. Members change their answers later under Channels & Roles at the top of the channel list.
It works well for "what are you here for" questions on day one. It can't post a menu in a channel, swap one colour for another, cap a role, or take a role away after a while, which is what the bot is for. Many servers use both. For a role every new member should get without picking, use the auto role bot instead.
Questions people ask
How do you make reaction roles on Discord?
Discord has no reaction roles of its own, so you use a bot. With BotGhost, switch on the free Reaction Roles module, pick buttons, a dropdown or reactions, add the roles, and post the menu in a channel. Members press or react and get the role.
Can you do reaction roles without a bot?
Not with reactions. The closest thing built into Discord is Onboarding in a Community server, where members answer questions when they join and each answer can give roles. They can change their answers later under Channels & Roles.
Why is my reaction role not working?
Nearly always the role order. A bot can only give roles below its own role, so open Server Settings, Roles and drag the bot's role above every role in the menu. The bot also needs the Manage Roles permission.
Can I add reaction roles to an old message?
Yes, for a reactions menu. Copy the message's link in Discord and run /reactionroles attach with it. Buttons and dropdowns can only go on a message your bot posts.
How many reaction roles can one message have?
Discord allows 20 different reactions on a message, so a reactions menu holds up to 20 roles. A BotGhost menu holds 20 roles in any style, and a bot can have 10 menus.
Is a reaction roles bot free?
BotGhost's Reaction Roles module is free on every bot, with every setting, and its command and events don't count toward the free plan's limits.