First, create the roles in Discord and drag YAGPDB's own role above every role it should hand out. Next, open the YAGPDB dashboard, add each role as a role command, put those commands in a group, and post a role menu for the group with the /rolemenu create slash command. For a role given automatically on join, use the Autorole page. Old guides that tell you to type -rolemenu or -role are out of date: YAGPDB has switched prefix commands off, so use slash commands.
Checked on each bot's own site or docs on 12 November 2026. We make PeakBot. Nobody paid to be in this post.
The four pieces, and the order they go in
YAGPDB's role system has four parts, and each one depends on the one before it:
- Role commands link a Discord role to a name members can use to give themselves that role.
- Groups collect role commands and set rules for them, for example "pick only one".
- Role menus post a message for a group, and members use it to pick their roles. This is what most people mean by "reaction roles" or "self roles".
- Autorole gives a role to everyone who joins, with no action from the member.
Work in this order: Discord roles, then role commands, then a group, then the menu. Most broken setups skip a step or do them out of order.
Step 1: Create the roles in Discord
- On desktop, open Server Settings > Roles > Create Role (Discord's roles guide).
- Name the role and pick a color if it is a color role.
- Self roles rarely need permissions. Leave them off, and never give a self-assign role Administrator or Manage permissions.
- Save your changes before you leave the page.
Two Discord rules to keep in mind here. New roles appear just above @everyone. A member's name color comes from their highest role, so color roles need to sit above any other colored roles members have, or the color will not show.
On the phone app, role settings live in the server's settings too, but the labels differ a little. Our mobile reaction roles guide goes through the phone side.
Step 2: Put YAGPDB's role above the roles it gives
This step fixes most "YAGPDB isn't giving the role" problems.
- Stay in Server Settings > Roles.
- Find the role YAGPDB got when you invited it. It is usually named after the bot.
- Drag it above every role you want YAGPDB to assign. Save if Discord asks you to.
- Open that role and confirm Manage Roles is on.
Discord only lets members with Manage Roles edit roles below their own highest role, and bots follow the same rule. YAGPDB's self-assignable roles docs say this too. If a role sits above the bot, the bot cannot give it, however you set up the dashboard.
Step 3: Add role commands in the YAGPDB dashboard
- Go to yagpdb.xyz, log in with Discord and pick your server.
- In the sidebar, open the Roles section and then Role Commands. Older guides call this "Tools & Utilities". The dashboard has moved things around since, so look for the Roles section.
- Add one role command per role. Give each a short, clear name, because members may type it.
- Set any role requirements or exclusions the page offers, if you need them.
Once a role command exists, members can also assign it with YAGPDB's role slash command. Type / in a channel to see what YAGPDB currently registers.
Step 4: Group the role commands
- On the same page, create a group, for example "Colors", "Pronouns" or "Pings".
- Add the matching role commands to it.
- Set the group's mode. Groups have a setting for whether members can hold one role or several from the group. Pick the one-only option for color roles, so a new pick replaces the old one. The docs list the exact modes.
Step 5: Post the role menu
- Go to the channel where the menu should live, for example #roles.
- Type
/rolemenu createand pick the group from the options Discord shows. - YAGPDB posts the menu message. Older menus use reactions.
- React to it yourself and make sure the role arrives.
YAGPDB's recent updates added a way to build and edit role menus in the dashboard, and a select-menu style picker as well. Old guides say menus can only be reactions made by command, which is no longer true. If your dashboard shows a menu option under Roles, you can build the menu there. If it doesn't, the slash command still does the job. The changelog on yagpdb.xyz has the details.
To change an existing menu, for example to add a new role, add the role command to the group, then run /rolemenu update with the menu's message ID. To copy a message ID, turn on Developer Mode at User Settings > Advanced > Developer Mode, then right-click the message and choose Copy Message ID (Discord's guide). On mobile, Developer Mode is under Settings > Advanced. After that, long-press the message and look for the copy ID option.
Step 6: Set up Autorole for new members
- In the YAGPDB dashboard, open Roles > Autorole.
- Pick the role every new member should get, and save.
- Make sure that role is below YAGPDB's role (Step 2).
One catch that most guides leave out: according to YAGPDB's Autorole docs, Discord's verification level only applies to members who have no roles. If Autorole gives a role the moment someone joins, that member skips your verification level. If you rely on that check, use a menu or a separate verification step to hand out the role instead of giving it on join.
Discord's own Onboarding can also give roles from questions members answer when they join, without any bot. See our guide to reaction roles without a bot.
Common problems and fixes
- Reacting does nothing. Check that YAGPDB's role is above the role, that it has Manage Roles, and that it can see the channel, read message history and add reactions there.
-rolemenu createdoes nothing. YAGPDB no longer reads prefix commands by default. Use/rolemenu create, or start your message by mentioning the bot.- Members can hold several color roles. Change the group's mode to the one-only option.
- The role is given but the color doesn't show. Another colored role sits higher. Move the color roles up.
- You can't find the message ID. Developer Mode is off. It lives under Advanced, not Appearance as some old guides say.
How PeakBot does it
PeakBot keeps every role automation on one dashboard page. Log in at peakbot.pro, pick your server and open Roles in the sidebar. You'll find auto roles on join, self-assign roles and if/then rules there, all on the Free plan. If you need members to pass a check first, the Verification page posts a panel with a button, with optional questions, an unverified and a verified role, and an auto-kick for anyone who never verifies. That avoids the Autorole and verification-level clash. Level-based roles are on the XP & Leveling page. The features page lists everything else, and the PeakBot docs walk through each screen.
The Discord rule from Step 2 still applies: PeakBot's role has to sit above the roles it gives.
YAGPDB has real strengths. Its custom-command scripting engine lets you build role logic that a settings page can't, and its free plan includes 25 automod rules. If your YAGPDB menus already work, you don't need to switch. PeakBot fits better if you'd rather click through role settings than learn commands and groups.
Frequently Asked Questions
Why isn't YAGPDB giving the role when I react?
It's nearly always role order. YAGPDB's role has to be above the role it gives, with Manage Roles on. After that, check that the bot can see the channel and read its history, and that the role command is actually in the menu's group.
Why doesn't -rolemenu create work anymore?
YAGPDB has turned prefix commands off, so -rolemenu and -role from older guides are ignored. Use the slash versions, such as /rolemenu create, or mention the bot at the start of the message.
How do I make members pick only one color role?
Put all the color roles in one group and set the group's mode to the option that allows a single role. When a member picks a new color, YAGPDB removes the old one.
How do I add a role to an existing role menu?
Add a role command for the new role, put it in the same group, then run /rolemenu update with the menu message's ID. If your dashboard has role menu editing, you can make the change there instead.
Can YAGPDB give a role after members accept the rules?
Autorole gives the role on join, so it skips Discord's verification level. To give a role only after members agree to the rules, put a role menu in your rules channel, or use Discord Onboarding or a bot verification panel.
Does this work on Discord mobile?
The YAGPDB dashboard works in a phone browser, and slash commands work in the app. You can do the Discord role steps on the phone as well, though the menu labels differ from desktop.
