LiveThe dashboard is here. Six years in the making.

Button Roles

Creating a Button Message

Make the message that hosts your buttons, then lay them out on the canvas.

Button roles live on a message Zira sent. You start by creating (or picking) that message, then build the buttons on the canvas below it.

Step 1: create the message#

The easiest path is the Embed Builder:

  1. Open Tools → Embed Builder.
  2. Design your message, content, embed, or both.
  3. Under Wire it up, choose Use for button roles.
  4. Send. Zira posts the message and drops you straight into the Button Roles builder with that message selected.
Tip

Already have a Zira-sent message you want to add buttons to? Open Configuration → Button Roles and pick it from the message selector at the top. Only messages Zira authored can carry buttons, that is a Discord rule, not a Zira one. To put buttons on someone else's message, use Migrating from reaction roles or have Zira repost it.

Step 2: add buttons#

On the Buttons card, click Add button. Each new button starts with one Normal (add) action. The list spells out what every button does (its actions, requirements, cooldown, and group), and the Preview card above shows the message exactly as Discord will render it. Click any button in the list to open its editor on the right, where you set:

  • Label and Emoji (a button needs at least one of the two).
  • Color (premium): grey, blurple, green, or red.
  • Its action chain, group, requirements, and cooldown (covered on the next pages).

Step 3: order them#

Buttons pack 5 per row, exactly how Discord lays them out. Drag a button up or down in the list to change its position; the rows update to match. A message can hold up to 25 buttons (5 rows of 5).

Step 4: save#

Nothing goes live until you press Save. Zira applies every change in one go and repaints the message so what members see always matches what you built. The save bar shows when you have unsaved changes and confirms once it lands.

Info

Editing the message's text or embed is done from the Embed Builder (open it in edit mode on that message). The Button Roles page manages the buttons; the Embed Builder manages the message body.

Permissions Zira needs#

  • Send Messages and Embed Links in the channel (to post the message).
  • Zira's role must sit above every role your buttons grant, see Permissions.
  • Manage Messages only if you use the migration tool's "clear reactions" or "delete original" options.