Skip to main content
Role menus post a permanent, interactive panel in any channel you choose. Members click a button to instantly assign or remove a role — no commands, no waiting for a moderator. Each menu can hold up to 25 roles, and you can enable “unique” mode to make it behave like a radio selector where picking one option removes any previously held menu role.

​
Commands

All role menu commands require Manage Guild.

​
Setting Up a Role Menu

1

Create the menu

Run /rolemenu create #roles "Pick Your Color" "Choose your favorite color role". Percy posts the empty panel in the channel and returns the new menu’s ID — you will need it for the next steps.
2

Add role buttons

Run /rolemenu add <menu_id> <@role> [emoji] [label] for each role you want to offer. The emoji and label are optional — if you skip the label, Percy uses the role name.
Percy updates the live panel message after every addition, so members see the new button immediately.
3

Enable unique mode (optional)

If members should only hold one role from this menu at a time — for example, a team color or a class selector — run:
When unique mode is on, clicking a new button removes the member’s current menu role before assigning the new one.

​
Full Example

This creates a color picker where a member can hold only one color role at a time. Clicking 🔴 Red while already holding 🔵 Blue swaps the roles automatically.

​
Managing Existing Menus

  • List menus: Run /rolemenu to see every menu, its ID, title, and the channel it lives in.
  • Remove a role: Run /rolemenu remove <menu_id> <@role>. The button disappears from the panel instantly.
  • Delete the whole menu: Run /rolemenu delete <menu_id>. Percy removes both the database record and the message in the channel.
Percy needs the Manage Roles permission to assign and remove roles. Additionally, each role you add to a menu must be below Percy’s highest role in the server’s role hierarchy. Roles above Percy’s top role, or roles managed by integrations, cannot be added to menus.
Use /rolemenu unique for any menu where choices are mutually exclusive — class selections, team assignments, region pickers, or notification tier opt-ins. For menus where members can hold multiple roles at once (e.g., interest tags or game pings), leave unique mode off.