Skip to main content

Documentation Index

Fetch the complete documentation index at: https://apetopia.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Reaction Roles let members pick their own roles in Discord by simply clicking a reaction on a message. Itโ€™s a great way to let people opt into announcements, choose their interests, or self-identify within your community โ€” without any manual work from your moderation team.

Open in Apetopia โ†’

Go directly to this feature in your dashboard.

How it works

You create a message in Discord that lists a set of options, each tied to an emoji. When a member clicks a reaction, they automatically receive the corresponding role. If they remove the reaction, the role is removed too. Example:
React to get your role! ๐ŸŽฎ Gaming ๐ŸŽจ Art ๐ŸŽต Music

Setting it up

  1. Go to Community โ†’ Reaction Roles
  2. Click Create New
  3. Choose the channel where the message will be posted
  4. Add each role-emoji pair you want to include
  5. Write an optional intro message that will appear above the reactions
  6. Click Post โ€” the bot will send the message and start listening for reactions

Tips

  • Keep the list short and meaningful. Too many options overwhelm members.
  • Use clear, recognizable emojis that match the role they represent.
  • Put your Reaction Roles message in a dedicated channel like #get-roles so members can always find it.
  • You can edit or delete a reaction role setup from the dashboard at any time.
The bot needs Manage Roles permission and its role must be positioned above the roles itโ€™s assigning in your Discord server settings.