serenity

Select Roles

A dropdown menu members pick their roles from.

Replace [prefix] with your server's prefix.

Select roles put every option behind one dropdown instead of a wall of buttons or reactions — the right choice when there are more than a handful of roles to pick from. One message can carry several menus.

Creating a Menu

The menu lives on a message Serenity sent, so start with an embed of your own:

  1. Post the message

    Use [prefix]embed create or any command that makes Serenity post — the menu attaches to that message.

  2. Create the menu

    // Syntax
[prefix]selectroles create [message] [name] [single|multi] [placeholder]

// Example
;selectroles create 1120102... colors multi Pick your colours

  3. Add the options

    // Syntax
[prefix]selectroles add [message] [menu] [label] [emoji] [role]

// Example
;selectroles add 1120102... colors Red 🔴 @red

Needs Manage Roles. [prefix]sr is the short form, and dropdownroles and menuroles work too.

ModeMembers can hold
singleOne role from the menu at a time
multiAs many as they like
A message with two select menus, one open showing its role options

Managing Them

CommandWhat it does
[prefix]selectroles remove [message] [menu] [label]Drop one option
[prefix]selectroles delete [message] [menu]Delete a whole menu
[prefix]selectroles removeall [message]Every menu on the message

The menu name is an internal id, not a label — it can't contain a colon, and it has to be short. What members see is the placeholder and the option labels.

Two menus on one message beat one menu with thirty options: colors and pings, each with its own placeholder, read as two questions instead of one enormous list.

Which Kind to Use

Button Roles

Up to a handful of roles, one click each, always visible.

Reaction Roles

Works on any message, including ones Serenity didn't send.