Skip to main content
A dropdown menu is a message with a role picker attached. It holds far more roles than reactions do, shows a label and description for each, and can be set to one role at a time or as many as the member wants.
This command needs Manage Roles, and Bloom needs Manage Roles too.

​
Building one

Run !dropdownroles create #roles and Bloom walks you through four steps in the channel you ran it from. Type cancel at any step to stop.
1

Message

The text or embed shown above the menu, written in the embed format. Type skip for a bare menu with no message.
2

Options

One role per line:
The fourth part is an optional description. Up to 125 options, spread over five menus of 25. Bloom tells you if it had to skip a line.
3

Settings

Optional, one per line. placeholder: Choose your roles sets the text on the closed menu, and mode: single limits members to one role at a time. Type skip for the defaults, which are multi-select and “Select roles”.
4

Delivery

Choose Send as Bot, or Send via Webhook to post it under your server’s own name and icon.

​
Managing your menus

​
Manage Roles
Aliases: dr, selectroles, dropdown.
  • !dropdownroles list shows every menu in the server.
  • !dropdownroles info shows one menu’s options.
  • !dropdownroles edit changes an existing menu’s options.
  • !dropdownroles delete #roles removes the menus in a channel.
  • !dropdownroles refresh rebuilds menus after roles have changed.
Every role in the menu must sit below Bloom’s own highest role. A role above it is skipped when the menu is built, or silently fails to apply if it is moved up later.

​
Troubleshooting

Bloom reports the lines it could not use. The usual causes are a role it cannot find, an emoji it cannot post, or a role ranked above its own.
Check Bloom’s role is still above the roles in the menu, then run !dropdownroles refresh. A role that was deleted and recreated has a new ID and needs the menu edited.
That is the ceiling for one message, being 25 options across five menus. Split them across several messages, grouped by theme.
Each step waits for your reply and then gives up. Run !dropdownroles create again to start over. Nothing is saved until the last step.

Reaction roles

A quicker option for a handful of roles.

Embed syntax

The format for the message above the menu.

Managing roles

Create the roles before you list them.

Autoroles

Roles given automatically on join.