Skip to main content

FAQ

Troubleshooting


Zira is not responding to my commands.

Zira needs the permissions Read Messages, Read Message History, Send Messages, and Embed Links.

Please make sure that Zira has these permissions both by role and by channel.

I keep getting the error: "Please set a channel and message first, then try this command again."

This means that you need set a channel with /channel <#Channel> and a message with /message set <Message ID> before you can setup roles.

See the Basic Reaction Role Setup guide for more details.

Zira is not adding reactions on a message.

If Zira is not reacting to your set message, then you probably forgot to set the channel and/or message.

Use /channel <#Channel> to set the channel where the message is going to be reacted. Then, use /message set <Message ID> to set the corresponding message in said channel.

See the Basic Reaction Role Setup guide for more details.

I already set the channel and message, but it still doesn't work.

Zira needs the permissions Read Messages, Read Message History, and Add Reactions in the channel the message is in.

If you are using any external emojis, Zira must also have the permission Use External Emojis.

Please make sure that Zira has these permissions both by role and by channel.

An easy way to give Zira these permissions is to re-invite Zira with all the permissions on https://zira.bot/invite. See the Permissions page for more details.

Zira has all the correct permissions, but it is still telling me that it can't use this emoji.

If you are trying to use external emojis, Zira must be in the same server that the emoji is from to be able to use it.

Zira reacted to the message, but it is not assigning any roles.

Zira needs the permission Manage Roles. Additionally, Zira's highest role must be higher than the role that is it trying to assign.

See the Getting Started guide for full setup instructions.

Using /embed json and /edit with a manual embed JSON is not working.

Please read the embed command documentation for a detailed explanation the type of input Zira expects for the embed and edit commands as well as a link to a helpful Discord embed visualizer.

Zira's reactions aren't staying in order.

We are unable to control the order of reactions on a message as it is Discord that handles how reactions are ordered on messages.

Reactions are not getting removed.

Zira will remove a reaction if it has the permission Manage Messages in the channel and the reaction meets the following criteria:

  • The reaction is on an active message but is not assigned to a role.

or

  • The type of the corresponding role is one of the following:
    • Once
    • Toggle
    • Remove

Otherwise, if any reactions remain, you will need to manually clean them up.

General


How do I find a message and channel ID?

See the Discord help page Where can I find my User/Server/Message ID? for instructions on how to find a message and channel ID.

Can I use multiple channels and messages?

Yes, you can use as many channels and messages as you desire for reaction roles by repeating channel and message commands as needed. Changing the active channel and message will not erase previously set up reaction roles.

See the Basic Reaction Role Setup guide for more details.

How many roles can I add to a single message?

Discord limits the total amount of reactions on a message to 20, but you can stack as many normal, toggle, and remove reaction roles on a single reaction as you wish. Please see the normal, toggle and remove commands for more details.

Premium Only

Normal free users of Zira may only have up to 100 total reaction roles per guild. Premium and partnered guilds can have unlimited reaction roles of any type!

Can I have a single reaction both add and remove roles?

Yes, you can stack normal, toggle, and remove reaction roles on a single reaction. Please see the normal, toggle and remove commands for more details.

Can Zira use custom emojis for reaction roles?

Yes, Zira can use custom emojis from any server that it is a member of. If the emojis are not located in the current server, please make sure that Zira has the permission Use External Emojis.

How can I use Zira to set up a gated server?

There are two methods you may use.

  1. Use a normal role gate.

    Set up all the channels except the rules channel to require a certain role (usually @member) that users gain by reacting to a reaction role set up with once or normal. See a detailed guide on setting up such channel permissions from Discord here.

  2. Use a reverse role gate.

    Use autorole to automatically assign a role to all users that hides all the channels except the rules channel. Set up a remove reaction role to remove the restricting role to expose the rest of the channels to the user.

How can I allow users to only react to a single role?

To allow users to only react once, use channel permissions to hide the reaction role message channel once a user has been given a role from a reaction role.

How do I delete a reaction role?

See the delete command documentation.

Will using /delete affect any current user roles or reactions on the message?

No, deleting a reaction role will not affect current users with the role. It will also not delete or otherwise change existing user reactions on any affected reactions.

Other

What is the difference between free and Premium Zira?

Please see the Premium page for current details.

Some features include the following:

  • Unlimited toggle and remove reaction roles.
  • Ability to have unlimited reaction roles per guild, it is limited to 100 without Premium.
  • Ability to send DMs to users when they add or remove reaction roles.
  • More suggestion system configuration options.
  • Ability to use timed roles.
  • Unlimited user and bot autoroles.