> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apetopia.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Reaction Roles

> Let members self-assign roles by clicking a button in Discord.

Reaction Roles let members pick their own roles in Discord by clicking a button on a message posted by the bot. 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.

<Card title="Open in Apetopia →" href="https://apetopia.co/dashboard/discord/reaction-roles">
  Go directly to this feature in your dashboard.
</Card>

## How it works

You create a **panel** — a bot message with a title, optional description, and a set of buttons. Each button is tied to a role. When a member clicks a button, they receive that role. Clicking it again removes it.

## Setting it up

1. Go to **Community → Reaction Roles**
2. Click **Create New**
3. Choose the channel where the panel will be posted
4. Add a **title** and optional **description** for the panel
5. Add buttons — each with a role, an emoji, and a label
6. Click **Save** — the bot posts the panel and starts listening for clicks

You can edit or delete any panel from the dashboard at any time.

## Tips

* Keep the list short and meaningful — too many options overwhelm members.
* Use a dedicated channel like `#get-roles` so members can always find the panel.
* Up to 25 buttons per panel.

<Note>
  The bot needs **Manage Roles** permission and its role must be positioned above the roles it's assigning in your Discord server settings.
</Note>