LiveThe dashboard is here. Six years in the making.

Guides

Basic Reaction Role Setup

Pick a channel, pick a message, drop in your first reaction role.

This guide gets you a working reaction role from scratch using slash commands. Three steps: set the active channel, set the active message, add the reaction role.

Tip

If you'd rather click than type, the Dashboard walks you through the same flow with a UI. The slash commands below remain the canonical interface.

Step 1: set a channel#

Tell Zira which channel the message you'll use lives in.

/channel <Channel>

Setting a Channel

Info

See the channel page for more detail.

Step 2: set a message#

Three ways to do this.

Option 1 - your own message#

If you've already posted the message you want to use, set it by ID:

/message set <Message ID>

The message must be in the channel you set in step 1.

See Discord's User/Server/Message ID guide for finding IDs (you'll need Developer Mode).

User Message

Info

See the message page for more detail.

Option 2 - have Zira send a plain message#

/message send <Your message text>

Zira sends the message to the channel from step 1, then sets it as the active target automatically.

Message Create

Option 3 - have Zira send an embed#

The dashboard's embed builder is the richest path: live preview, every Discord embed option, and a one-click "Use as reaction-role target" wire-up that sets the channel and message for you. Open it at Tools → Embed Builder in your server dashboard.

Info

Prefer slash commands? /embed is still supported. Use /embed builder for an interactive builder right in Discord, or /embed json <json_content> to post an embed from raw JSON. The dashboard builder is the easier path for most servers, but /embed covers the same job.

Step 3: add reaction roles#

Now stack reaction roles onto the message you just set. Pick a type:

  • normal: react to add the role, un-react to remove it.
  • once: react once, the reaction is consumed and the role is permanent.
  • toggle: only one toggle role per message can be active at a time.
  • remove: react to have a role removed from you.

The command shape is the same for every type. Here's a toggle:

Using Toggle Command

You're done#

That's the entire flow. Add more roles to this message, set up additional messages, or jump to the Dashboard to manage everything visually from here.

Need help? Drop into #zira-support in our support server.