Reaction Roles — Ori Discord Bot
What does the reaction roles plugin do?
Section titled “What does the reaction roles plugin do?”Ori’s reaction roles plugin lets members self-assign roles by clicking buttons on a message in your Discord server. Set up emoji-to-role mappings in the dashboard, choose your button style, and Ori posts the embed. Members click a button to get a role, click again to remove it. No commands for members to learn, no configuration in Discord itself. Free for all servers.
The dashboard provides a visual builder where you map emojis to roles, customize button colors and labels, and preview exactly what the message will look like in Discord before posting it.
How do I set up reaction roles?
Section titled “How do I set up reaction roles?”- Open the Ori dashboard at oribot.org
- Select your server
- Click Plugins in the sidebar
- Find Reaction Roles and click the toggle to enable it
- Click into Reaction Roles to open its settings
- Click Create New Message
- Select the channel where the role menu should appear
- Write a title and optional description for the embed
- Add role mappings:
- Pick an emoji (Unicode or your server’s custom emoji)
- Select the role it assigns
- Choose a button color (blurple, grey, green, or red)
- Optionally customize the button label
- Repeat for each role you want to include (up to 25)
- Preview the result in the dashboard
- Click Post — Ori sends the message with buttons to your channel
What it looks like
Section titled “What it looks like”In the dashboard
Section titled “In the dashboard”What your members see
Section titled “What your members see”Configuration
Section titled “Configuration”- Channel (required) — Where the reaction role message appears.
- Title — The heading of the embed. Example: “Pick your roles”
- Description — Text displayed in the embed body above the buttons.
- Emoji-to-role mappings — Each mapping connects one emoji to one Discord role. Add up to 25 per message.
- Button color — Each button can be blurple, grey, green, or red.
- Button label — Text displayed on the button next to the emoji. Defaults to the role name.
How do members use reaction roles?
Section titled “How do members use reaction roles?”Members click a button on the reaction role message to receive the associated role. When they click the same button again, the role is removed. Ori sends a brief confirmation message that only the member can see (an ephemeral message) confirming the role was added or removed.
No commands to type. No reactions to add. Just click.
Limits
Section titled “Limits”- Maximum role mappings per message: 25
- Custom emoji must be from your own server (not other servers)
- Ori’s role must be positioned above the roles it assigns in your server’s role hierarchy
- Ori needs the Manage Roles permission
What reaction roles cannot do
Section titled “What reaction roles cannot do”Ori’s reaction roles cannot restrict who can use them. All server members can click reaction role buttons. There is no way to limit reaction roles to specific roles or member groups.
Ori’s reaction roles cannot assign multiple roles per button. Each button maps to exactly one role. If you want a member to get multiple roles at once, they need to click multiple buttons.
Ori’s reaction roles cannot use custom emoji from other servers. Only Unicode emoji and emoji uploaded to your own server are supported.
Ori’s reaction roles cannot be created via slash commands. All reaction role setup is done through the dashboard.
Ori’s reaction roles cannot enforce exclusive mode across multiple messages. If you have two separate reaction role messages, a member can pick roles from both.
Troubleshooting
Section titled “Troubleshooting”Members click the button but don’t get the role
Check that:
- Ori has the Manage Roles permission
- Ori’s role is above the target role in your server’s role hierarchy (Server Settings → Roles → drag Ori’s role higher)
- The target role is not managed by another integration (Discord marks some roles as “managed” and prevents bots from assigning them)
The buttons aren’t showing on the message
Make sure you added at least one emoji-to-role mapping before posting. A reaction role message with zero mappings won’t display buttons.
I want to edit an existing reaction role message
Open the reaction role message in the dashboard, make your changes, and save. Ori updates the existing Discord message in place — no need to delete and recreate.
Frequently asked questions
Section titled “Frequently asked questions”Is Ori’s reaction roles plugin free? Yes. All features including unlimited mappings (up to 25 per message), custom emoji, and button colors are free.
Can members remove a role by clicking the button again? Yes. Clicking a role button toggles it — adds the role on first click, removes it on second click.
Can I use custom emoji from my server? Yes. Any emoji uploaded to your server works as a button label.
How many roles can I add to one message? Up to 25 role-button mappings per message. Need more? Create a second reaction role message.
Does Ori send a confirmation when a role is assigned? Yes. Ori sends an ephemeral message (visible only to the member who clicked) confirming the role was added or removed.