> For the complete documentation index, see [llms.txt](https://docs.appy.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appy.bot/getting-started/reaction-roles.md).

# Reaction roles

Let your members choose roles by clicking buttons on a message.

## Set up reaction roles

1. Select your server on the dashboard and go to **Community > Reaction Roles**.
2. Click **New Reaction Role**, enter a name and click **Create Reaction Role**.
3. Click the pencil beside your new reaction role.
4. Choose a channel, then write a **Normal message** or **Embed**.
5. Click **Add Button**. Give it some text or an emoji, choose its colour and select the roles it should give.
6. Keep **Enabled** on and click **Save** to post the message.

You can add up to five buttons, with up to five roles on each button. Clicking a button adds any of its roles the member is missing and removes any they already have.

## Optional settings

Turn on **Require Rule Screening** if members should accept your server's rules before picking roles. Use **Refresh channels and roles** if a new channel or role is missing.

Free servers can create one reaction-role message. Premium servers can create up to 50.

Appy needs **Manage Roles**, and its role must be above the roles on your buttons.
