Reaction Roles: A Complete Setup Guide
How Airwavy's button-based reaction roles work, the free vs Premium panel limits, and how to keep self-service roles safe.
Quick answer
Reaction roles — also commonly called self roles — let members self-assign roles from a published panel, without a staff member handling it manually. Despite the name, members select Discord buttons rather than adding emoji reactions. Free servers can publish one panel with up to five roles; Server Premium raises that to ten panels with up to 20 roles each.
What you'll learn
- Why the feature is still called 'reaction roles' even though it uses buttons
- The free vs Premium panel and role limits
- Which roles are safe to offer for self-assignment, and which never should be
- How to set up and publish a panel
- Common mistakes that create a real security gap
Why self-service roles matter
Without self-service roles, every interest tag or notification opt-in requires a staff member to manually assign it — which doesn't scale, and creates a bottleneck for something that shouldn't need staff involvement at all. A published panel lets members opt into exactly what they want, instantly.
What Discord itself offers
Discord has no native self-assignable-role panel — role assignment is otherwise a manual, staff-only action through Server Settings or a slash command with the right permission. Any self-service flow comes from a bot.
How Airwavy's reaction roles work
Panels use reusable Discord button interactions — the feature name is retained for familiarity, but members click buttons rather than adding emoji reactions.
- Panels can be published in text or announcement channels with a custom title, description, and button label, emoji, and visual style.
- Free servers can publish one panel with up to five roles; Server Premium supports up to ten panels with up to 20 roles on each.
- Selecting a panel option grants its mapped role; removing or toggling the selection follows the panel's configured behaviour.
Set it up
- Create the assignable roles first, and place all of them below Airwavy's role.
- Open Reaction Roles in the dashboard and create a panel.
- Set its channel and message, then map each option to a role.
- Save or publish the panel, then test both adding and removing a role with a normal member account.
Common mistakes
- Mapping a privileged role — Administrator, moderation, staff, or an integration-managed role — to a self-service panel. Never do this.
- Placing a panel role above Airwavy's own role, so the grant silently fails.
- Not re-testing after changing role order, channel access, or the panel message — any of these can break a previously working panel.
- Offering roles that aren't actually safe for any eligible member to hold, just because it's convenient to add them to the panel.
Troubleshooting
The interaction responds but the role doesn't change
Grant Manage Roles and place Airwavy above the mapped role. Never map an administrator or similarly privileged role.
I've hit the panel or role limit
Free servers get one panel with up to five roles; Server Premium raises this to ten panels with up to 20 roles each.
A role stopped working after a permissions change
Re-test the panel after any change to role order, channel access, or the panel message itself.
Related guides
What Is a Starboard and Why Your Server Needs One
How Airwavy's starboard highlights popular messages automatically — threshold, eligibility, and the Premium customization options.
Read guideDiscord Autorole: Automatically Assign Roles to New Members
How to grant a role automatically the moment someone joins your Discord server — no reaction or button click required.
Read guide