Skip to main content
Note:
Welcome to the new Zira documentation, if you find anything wrong here or something that is broken, please report it at https://discord.gg/zira

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 z/channel and a message with z/message 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 z/channel to set the channel where the message is going to be reacted. Then, use z/message 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 server that the emoji is from.

Otherwise, you are likely calling the commands wrong and reversing the role and emoji.

The proper syntax:

z/add :rabbit: @Rabbitor
z/once :rabbit: Rabbitor
z/remove :rabbit: 579530921498378260

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 z/embed and z/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.

Discord 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.

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.

The user that is setting the reaction role must have Discord Nitro if they are trying to set a reaction role with an external and/or animated emoji.

Users that want to set external or animated emojis will otherwise need to find the full name of the emoji, which can be found by adding a \ in front of the emoji before sending the message.

Custom Emoji Slash Custom Emoji Full Name

Then, remove the preceding <: characters and the ending > character and use it in the reaction role command.

Custom Emoji Raw Add

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 z/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.

Can I change the language for Zira?

Languages are currently disabled while we migrate translation platforms.

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 send DMs to users when they add or remove reaction roles.
  • More suggestion system configuration options.
  • Ability to use timed roles.

Can I help translate Zira?

Translation requests are currently disabled while we migrate.