Skip to main content
A reaction role ties an emoji on a message to a role. Members react to get the role and remove their reaction to lose it. You can attach one to any message that already exists, which makes it the quickest self-service option to set up.

Setting one up

1

Post the message

Write the message members will react to, in the channel where you want it. Any message in your server works, including one Bloom posted.
2

Copy its link

Right-click the message and choose Copy Message Link.
3

Pair an emoji with a role

Run !reactionrole <link> 🎮 Gamer. Bloom saves the pair and adds the reaction itself, so members can click it straight away.
Creates the pair. Alias: rr. Bloom needs Manage Roles and Add Reactions.
  • The message must be in this server.
  • The role can be a mention, an ID, or a name.
  • Each emoji on a message can carry one role. Use a different emoji for each role.
  • Custom emoji work, and you can type an emoji’s name if you cannot post it directly.

Managing what you have

Bloom can only assign roles below its own highest role. If a self-assignable role is moved above Bloom’s, reacting silently stops working.

Troubleshooting

Check the pair still exists with !reactionrole list, that Bloom can see the channel, and that the role has not been moved above Bloom’s own role.
Pairs are tied to a message ID. Editing is fine, but a deleted and reposted message is a new message and needs setting up again.
Bloom tests the emoji by reacting with it. Emoji from other servers that Bloom is not in cannot be used. Pick an emoji from this server or a standard one.
Past a handful of options, a dropdown menu is easier to read and holds far more roles.

Dropdown menus

A tidier picker for larger sets of roles.

Autoroles

Roles given automatically on join.

Managing roles

Create and edit the roles you want to offer.

Permissions and hierarchy

Why Bloom’s role position decides what it can assign.