Reaction roles & self-roles

With reaction roles, members grab their own roles – for games, languages or notifications, for example. yurna offers three selector modes:

• Reactions – members react with an emoji and get the matching roles. If they remove the reaction, the roles go away again.
• Dropdown – a Discord select menu below a message.
• Buttons – one button per option, each with its own style, emoji and label.

You'll find the page under Dashboard → Community → Reaction roles (/dashboard/<server>/reaction-roles). Each configuration appears there as a card you can edit or delete.

Setting it up#

1. Click New Reaction Role.
2. Optional: enter a Rule name so you can find the configuration quickly later.
3. Choose the Channel.
4. Choose the Selector mode: Reactions, Dropdown or Buttons.
5. Choose the Message source:
   • Existing message – yurna uses a message that's already in the channel. Enter its Message ID. This only works with reactions.
   • Dashboard embed – yurna publishes a new embed message that you design right here. This is required for dropdowns and buttons.
6. Under Options, define what members can pick. Each option needs an Emoji and at least one Role. Use Add option to add more.
7. Click Save.

Within about a minute, yurna publishes the message or adds the reactions below the existing message.

Settings#

Embed message#

For a dashboard embed you design the Embed title, Description, Footer, Thumbnail URL, Image URL and Embed color. The Live preview shows you the result, including buttons or the select menu.

Options#

• Emoji – a Unicode emoji or one of your server's emojis. Each emoji can only be used once per configuration.
• Roles – one or more roles the option grants.
• Label and Description – optional, e.g. as button text or text in the select menu.
• Button style – buttons only: Blurple, Grey, Green or Red.

Dropdowns and buttons support at most 25 options – Discord doesn't allow more.

Multiple selection#

With Allow multiple selection, members can hold several options at once. When it's off, a member only keeps the roles of the option they picked last.

Behaviour (dropdown and buttons)#

• Mode
  • Toggle – one click gives the role, another click removes it.
  • Add only – roles can only be taken, not dropped again.
  • Remove only – roles can only be dropped, e.g. to unsubscribe from notifications.
• Maximum at once – the most options a member may hold at the same time. Empty means unlimited. Only applies with multiple selection.
• Requirement – only members with this role can pick, for example after accepting the rules.

Deleting#

When deleting, you can choose Also remove user reactions. yurna then clears the existing reactions below the message as well. Roles that were already given stay with the members.

Common problems#

• Roles aren't being assigned. yurna needs Manage Roles and must be above the roles it hands out. With buttons and select menus, yurna names any roles it isn't allowed to give directly in its reply.
• "This message could not be found". The channel and message ID don't match, or the message was deleted.
• You can't create a new reaction role. yurna needs at least one text channel and one role (other than @everyone) that it can see.

See also#

• Join & rules
• Verification
• Ping roles
• Permissions