Iris
Add to Discord
Docs

Self Roles

Let members pick their own roles from menus.

Configure Self Roles in the dashboard →

Overview#

Self roles posts a list of roles that members give themselves. Members pick with reactions, buttons or a dropdown, whichever the list is set to. Taking a role and dropping it again are the same action twice. No staff involvement, no command to remember.

Lists are built in a three-step designer: choose the roles and their order, style the embed, then post it. A server can run as many lists as it needs, so colours, pronouns, ping groups and regions each get their own message.

Editing a list afterwards re-syncs the posted message. Roles you added appear, roles you removed are cleared, and nothing has to be reposted. Switching between reactions, buttons and a dropdown re-syncs the same way.

Setup#

  1. Drag Iris above every role the list will hand out, in Server Settings > Roles.

  2. Open the dashboard and go to Community > Self Roles.

  3. Press New list, or start from one of the templates.

  4. On Roles, name the list and add your roles. Drag to set the order they appear in.

  5. On Appearance, set the title, description, colour and footer, choose how members pick roles, and decide whether the embed shows role mentions.

  6. On Save & Post, pick the channel and post it.

Settings#

SettingTypeDefaultWhat it does
List nameText-Short internal name used in commands, for example colors. Lowercase, no spaces needed.
RolesRolesNoneThe roles on this list, in the order they are shown. At least one is required.
TitleTextNoneHeading of the posted embed.
DescriptionTextNoneBody text above the role list. Say what the roles are for.
Embed ColorColour#105380The embed accent bar.
Footer TextTextNoneSmall line under the list.
How members pick rolesReactions / Buttons / DropdownReactionsReactions puts one emoji per role on the message. Buttons puts one button per role under the embed. Dropdown puts a single multi-select menu there instead. Buttons and dropdowns are limited to 25 roles by Discord.
Role mentionsToggleOffOn shows each role as a real mention in its own colour. Off shows the plain role name in bold.
Post to channelChannelNoneWhere the list is posted. Reposting to a different channel moves it.

Commands#

The slash group is retired in favour of the designer. The prefix commands remain so lists are still reachable when the dashboard is not.

  • .selfroles help Create, edit, post and delete role lists from chat. Manage Roles

Permissions#

PermissionWhy Iris needs it
Manage RolesGives and takes the roles members react for.
Add ReactionsAdds one reaction per role, on reaction lists.
Read Message HistoryFinds the posted list again to keep it in sync.
Send MessagesPosts the list.
Embed LinksThe list is an embed.

What it looks like#

I
Iris APP Today at 11:21 PM
Colour Roles

React below to pick your colour. Remove the reaction to take it off again.

🔴 Red
🔵 Blue
🟢 Green
🟣 Purple

One colour at a time works best
🔴 1🔵 1🟢 1🟣 1
A posted list. Iris has already added the reactions.

Tips and gotchas#

Reacting or clicking does nothing.

The role sits above Iris in the role list, or the message was posted by a different bot. Check the role order first.

Can I use buttons or a dropdown instead of reactions?

Yes. Set it under How members pick roles on the Appearance step, or run .selfroles mode <list> buttons (or dropdown). Save and the posted message swaps over.

How do I show the role mention instead of the bold name?

Turn on Role mentions on the Appearance step, or run .selfroles mentions <list> on.

I added a role but its reaction is missing.

Save the list. Saving re-syncs the posted message and adds the new reaction.

Can members hold more than one role from a list?

Yes. Each reaction is independent, so a member can take as many as they like.

Someone removed the reactions.

Only members with Manage Messages can clear them. Save the list to put them back.