Newt Docs Premium Status Support
Log in Add to Discord

Reaction roles and role buttons for Discord

Post a panel of buttons and members click to give themselves roles, like colours, pings or pronouns. Or tie an emoji on any message to a role.

Buttons answer privately, so the person clicking knows it worked. Reactions stay quiet.

What it does

  • Role button panels built on the dashboard, up to 25 buttons each
  • One-role-only panels, where picking a second swaps it
  • Emoji reaction roles on any message
  • Edits update the existing message, so links keep working
  • Keeps working through restarts and updates

How to set it up

🎛️ Role buttons

  1. On the dashboard, open your server, go to Role buttons and add a panel. Give it a heading, pick the channel, tick the roles, and save. The bot posts the message within a few seconds.

  2. From Discord, /rolepanel create makes an empty panel and /rolepanel addrole puts a button on it. The message appears as soon as the first role is added.

  3. As with autorole, the bot's role has to sit above every role on the panel.

🙂 Reaction roles

  1. Right-click the message in Discord and copy its link. Then run /reactionrole add with that link, the emoji, and the role. The bot adds the emoji to the message itself, so people have something to click.

  2. The message can be anybody's, in any channel the bot can read. If it is in the channel you are typing in, the message id on its own is enough.

  3. The bot's role has to sit above the role it hands out, the same as for panels.

Commands

CommandWhat it doesWho can use it
/rolepanel create <channel> <title> [description] [mode] Start a new panel. Manage Roles
/rolepanel addrole <panel> <role> [label] [emoji] Put a role button on it. Manage Roles
/rolepanel removerole <panel> <role> Take a button off. Manage Roles
/rolepanel list Every panel, its roles, and anything that went wrong. Manage Roles
/rolepanel delete <panel> Remove the panel and its message. Manage Roles
/reactionrole add <message> <emoji> <role> [channel] Tie an emoji on a message to a role. Manage Roles
/reactionrole remove <message> <emoji> Untie it again. Manage Roles
/reactionrole list Every reaction role in the server. Manage Roles

Questions

Is it free?
Yes. A free server can have 10 role panels and 20 reaction roles, and Premium raises those to 25 and 60.
Why doesn't clicking give the role?
The bot's own role has to sit above the role it gives out, in Server Settings, then Roles. Discord won't let any bot hand out a higher role.
Buttons or reactions: which should I use?
Buttons. They can tell somebody why nothing happened, and they don't break when a custom emoji is deleted.

More from Newt

Add Newt to your server

Free, and nothing runs until you switch it on.