Discord Reaction Role Template
The Discord reaction role template tool gives you ready-made message text for self-assign role panels. Pick a template, edit the emoji and role names to match your server, post the message, and configure your reaction role bot to watch it.
How Discord reaction roles work
Discord has no built-in reaction role feature. To use reaction roles, you need a bot that monitors a message for reactions and assigns or removes roles based on which emoji a member clicks. Popular options include Carl-bot, Dyno, and Reaction Roles.
The template tool generates the message text that lists which emoji grants which role. You post that message in your server, add the same emoji as reactions to the message, and then point your bot at the message ID to start the assignment logic.
The four template types
Basic reaction roles is a general-purpose template listing emoji-role pairs. Use it when you have a handful of unrelated roles — for example, Gamer, Artist, and Announcement pings — that members choose independently.
Color roles is designed for servers with per-member color displays. The message tells members to remove their old color reaction before picking a new one, which prevents a member from getting multiple color roles at once.
Ping roles is for notification subscriptions. Members react to opt in to event reminders, giveaway alerts, or news updates. These roles typically do not grant access to channels — they only let you @mention a subset of members.
Region roles is for gaming and community servers that organize members by geography. NA, EU, APAC, and OCE are common options. Use these roles when scheduling events or filling LFG posts.
Setting up the message
Choose a template from the dropdown and copy the text. Open your server and navigate to the channel where you want the panel — a dedicated #roles channel works best.
Paste and post the message. Edit the emoji and role names before posting if they do not match your server exactly. For example, change 🎮 — Gamer to 🎮 — FPS Gamer if that is more precise.
After posting, add each emoji as a reaction to that message. The bot reads the reactions on the message, not the text inside it, so the emoji must match exactly.
Configuring the bot
Most reaction role bots need the message ID and channel ID of your posted panel. Enable Developer Mode in Discord Settings, then right-click the panel message and click Copy Message ID.
In the bot's dashboard or command interface, add a reaction role entry pointing to that message ID. Map each emoji to the corresponding role. The bot will then handle assignments automatically when members click reactions.
Test with a secondary account before advertising the panel. Join your server with an alt, click a reaction, and confirm the bot assigns the correct role. Then check that removing the reaction also removes the role.
Designing readable panels
Keep panels short enough to read on mobile without scrolling. Roughly five to eight emoji-role pairs per message is a comfortable maximum. If you need more options, split them across multiple messages in the same channel.
Separate cosmetic roles from notification roles in different panels. Members looking for color roles should not have to sift through ping-role options to find them.
Pin the reaction role message so new members find it easily. Link to it from your welcome channel or rules channel so it is part of the standard onboarding flow.
Custom emoji
If your server has custom emoji, you can swap them into the template. Type the custom emoji directly into the message text. Then add the same custom emoji as reactions to the message.
Custom emoji from other servers only render for members who share a server that has that emoji. Nitro members can use any custom emoji anywhere. For public servers, prefer default Discord emoji to avoid blank boxes.
Maintenance
If you rename a role, update the panel text and edit the pinned message. Check the bot configuration to make sure the emoji-to-role mapping still points to the correct role IDs — bots usually track by role ID, not name, but confirm this.
If a bot removes a role when the reaction is removed but does not add it when added, check that the bot has the correct permissions in the channel and that the emoji in the bot config matches the reaction on the message exactly.
Explore more discord tools on Tolz.me.