Docs / Guides / Let members pick their own roles

Let members pick their own roles

In short

You will have a posted role menu members can click, with limits you choose. A /roles list for members who prefer commands is optional.

Role menus are part of the Welcome service. Before you start, move the bot's role above every role members will pick.

1. Turn on Welcome

On the dashboard's Services page, turn on the Welcome switch. Then open the Role menus page and press New menu.

2. Optional: Start from a template

At the top of the new menu, under Start from a template, pick one and press Use this template.

The templates and the roles they create
  • The templates are Name colours, Pronouns, Notifications, Regions and Platforms.
  • The bot creates the roles for you with no permissions, directly below its own role. A role that already has the same name is reused.
  • It builds a draft menu to check and publish.
  • Until the menu is posted, Delete the roles this template created removes the roles again.

3. Choose how members pick

Under How members pick, set Layout to Buttons, Dropdown or Emoji reactions. Then set Choice.

Choice options and role limits

Choice is one of:

  • Any combination.
  • One at a time.
  • Add only (nothing takes the role away).
  • Remove only (nothing gives it).
  • Reversed (picking takes the role away and un-picking gives it back, for opt-out roles).
  • First pick is final.

Max picks caps how many roles a member can hold from the menu (0 means no limit). Buttons and a dropdown take up to 25 roles. Emoji reactions take up to 20.

4. Add the roles

On the Roles card, press Add a role. For each one, pick a Role, an emoji and a label.

Emoji, extra roles and roles you cannot add
  • On buttons and a dropdown the emoji is optional. On an emoji reaction menu every role needs its own emoji. A custom emoji has to come from a server the bot is in.
  • Also give adds up to 4 more roles that one pick gives and takes together.
  • Most members caps how many members can hold a role (0 means no limit). A full role is refused.
  • Roles the bot cannot hand out are greyed out with the reason. A role above the bot's top role cannot be given, so move the bot's role higher.
  • Roles that grant a privileged permission are left out of the list and cannot be self-assigned.

5. Pick the channel and write the message

Under Where it lives, pick the Channel to post into. Under Message, choose a Style and write a Title and Text.

Permissions, styles and using an existing message
  • The bot needs View Channel, Send Messages and Embed Links in the channel. A reaction menu also needs Add Reactions.
  • Embed has a title, colour and pictures. Plain text uses markdown.
  • To use a message that is already in the server, pick Use a message already in the server and paste its message link. That works with emoji reactions only.

6. Optional: Limit who can use it and change the reply

Under Who can use it, set Needs one of these roles or Not for members with these roles. Under Replies, set Reply.

Who gets refused and what members see
  • Leave both role lists empty and every member can use the menu.
  • On buttons and a dropdown, anyone else gets a short private reply saying why.
  • A reaction menu never replies: it takes their reaction back off. For that, the bot needs Manage Messages in the channel.
  • Reply is what a member sees privately after a click on buttons or a dropdown: what changed, nothing or your own text.
  • A refused pick always gets a reply, with the reason or your own When a pick is refused text.

7. Save and publish

Press Save and publish. On the Role menus page, the menu changes from Draft to Live.

Drafts and pausing a menu
  • Save and publish waits until a channel and at least one role are picked. Save keeps a draft.
  • To pause a menu, switch Menu is on off. A paused menu stays in Discord but changes nobody's roles.

8. Optional: Add a /roles list

On the Roles page, under Self-assignable roles, turn on Turn on /roles and pick up to 25 Roles members can pick.

How members use /roles
  • Members see the list with /roles list, add a role with /roles add and drop one with /roles remove.
  • Only roles on the list can be picked. The replies are private.
  • Roles the bot cannot hand out are greyed out with the reason.
  • See /roles add.

9. Check that it works

Use a test account to click a button, pick from the dropdown or add a reaction. Then run /roles list if you turned it on.

What you should see
  • A button or dropdown pick answers privately. By default it says "✅ Added {role}" when it gives a role and "➖ Removed {role}" when it takes one off, with the role filled in.
  • The test account now has the role.
  • /roles list shows the self-assign list with a check mark next to roles the member has.

Next

Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord