Ethvex logo Ethvex Docs
Updated Invite

Reaction Roles

Let members pick their own roles with reactions, buttons or dropdown menus.

System Slash Prefix % Aliases: %rr, %rroles 3s cooldown

Usage #

/reactionroles
<required> must be included[optional] can be left outDo not type the brackets

Permissions #

You need
Manage Roles
Ethvex needs
Manage Roles
Cooldown
3 seconds

Free and Pro #

Free

5 groups, every style and every mode

Pro

Unlimited groups

Compare plans

Groups #

Reaction roles are organised in groups. Each group is one message with a set of roles on it, like "Pick your colour" or "Pick your pronouns". Press New Group to start one.

Styles #

StyleHow members pick
ReactionClick an emoji reaction under the message.
ButtonClick a button. Buttons can have a label, emoji and colour.
SelectChoose from a dropdown. You can set the placeholder text and how many options can be picked.

Modes #

The mode decides what happens when someone picks a role. All five modes are free.

ModeBehaviourGreat for
NormalPick to get the role, pick again to remove it.Interest and ping roles
UniqueOnly one role from the group at a time. Picking a new one swaps it.Colour roles, regions
VerifyGives the role but never takes it away.Verification and rules agreement
DropOnly removes the role. Handy for letting people opt out.Removing a default role
BindingOnce you have it, it is yours. It cannot be removed through the panel.Permanent choices

Building a group #

Name it and choose a style and mode

Names must be unique within your server.

Add entries

Each entry links an emoji or label to a role. Select menus can also show a description.

Design the message

Choose Plain Text, Embed or Container. Plain Text and Embed let you set the title, body, footer, colour, image and thumbnail. Container works like a block builder, see below.

Set the target

Pick the channel. Leave the message ID empty to post a new message, or paste an existing message ID to attach the roles to it.

Save

Press Save and then Apply to Message to publish it.

Container design #

Pick Container as the message type to build the panel out of blocks, like a welcome message. Stack up to 8 blocks:

BlockWhat it adds
Text BlockMarkdown text, with bold, italic and custom emojis.
SectionText with an optional thumbnail image on the right.
Image GalleryUp to 4 images in a grid.
SeparatorA line between blocks.

Move blocks with the ↑ and ↓ buttons and pick an accent colour from the presets or any hex code. The role buttons or dropdown sit under your blocks.

Guards #

  • Max roles limits how many roles from the group one member can hold. 0 means unlimited.
  • Denied roles stop members with certain roles from using the panel at all.
  • DM on fail tells the member privately why they could not get a role.

The Ethvex role must be above every role in the group, or it will not be able to give them out.

Examples #

/reactionroles
Opens the reaction role manager.