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

Suggestion

The suggestion command is used to set up a suggestion system with Zira. Users can send suggestions to the system with commands, and specified roles can approve and deny these sent suggestions.

Video Example

Coming Soon!

Usage

You can see all current suggestion commands by running the command with no arguments.

z/suggestion

Setting up the suggestion system

The suggestion new command is used to enable or disable the suggestion system and simultaneously set a channel to collect all new user suggestions.

z/suggestion new #new-suggestions    # by channel name
z/suggestion new disable # disable the suggestion system

Each time a user posts a suggestion, it will be sent to the set channel and available for reviewing and voting if public access is enabled.

z/suggestion new example

tip

Check out the other pages in the Suggestion Commands section for submission and suggestion status change commands.

Setting up collection channels

Approved suggestions

By default, suggestions marked as approved with the approve command will be updated in the submission channel set up in suggestion new. To have approved suggestions moved to a new channel, use the suggestion approved command.

z/suggestion approved #approved-suggestions   # by channel name
z/suggestion approved disable # disable separate channel

z/suggestion approved example

Denied suggestions

By default, suggestions marked as denied with the deny command will be updated in the submission channel set up in suggestion new. To have denied suggestions moved to a new channel, use the suggestion denied command.

z/suggestion denied #denied-suggestions     # by channel name
z/suggestion denied disable # disable separate channel

z/suggestion denied example

Invalid suggestions

By default, suggestions marked invalid or as spam with the invalid command will be updated in the submission channel set up in suggestion new. To have invalid suggestions moved to a new channel, use the suggestion invalid command.

info

We recommend that this should be set to a moderator-only channel since these suggestions are either abusive or bad suggestions.

z/suggestion invalid #invalid-suggestions    # by channel name
z/suggestion invalid disable # disable separate channel

z/suggestion invalid example

Potential suggestions

By default, suggestions marked as potential with the maybe command will be updated in the submission channel set up in suggestion new. To have invalid suggestions moved to a new channel, use the suggestion potential command.

z/suggestion potential #potential-suggestions   # by channel name
z/suggestion potential disable # disable separate channel

z/suggestion potential example

Moving suggestions to a different channel

Premium Only

The suggestion move command is a Premium and partnered guild feature.

The suggestion move command is used to move a suggestion to a different channel manually.

# Suggestion IDs are found in the footer of existing suggestions
z/suggestion move UYAWV #random-channel # by suggestion ID, channel name
z/suggestion move 591200899255500840 591200779675893760 # by message ID, channel id
info

suggestion move commands will be deleted in their original channels upon processing.

Setting up permissions for status change commands

Use the suggestion role command to limit access to suggestion status change commands such as approve and deny.

z/suggestion role @Rabbit   # by mention
z/suggestion role Rabbit # by role name

z/suggestion role examples

Additional configuration options

Premium Only

All following suggestion system configuration options are Premium and partnered guild features.

Setting up a specific user suggestion channel

By default, Zira will accept user suggestions from any channel it has read access. Premium and partnered guilds may instead set up a specific channel for user suggestions using suggestion submit.

z/suggestion submit #suggestions    # by channel name
z/suggestion submit disable # disable specific channel

z/suggestion submit example

Setting up DM updates for users

The suggestion dm command toggles the ability for users to receive updates by DM for suggestions that have been updated to a different status.

z/suggestion dm

z/suggestion dm examples

Setting up automatic voting reactions on new suggestions

The suggestion reaction command toggles the ability for two emojis to be automatically added to new suggestions as reactions. This is useful for public user voting.

z/suggestion reaction

command example

To configure the two emojis, use the suggestion emojis command.

z/suggestion emojis :carrot: :rabbit:

z/suggestion reaction examples

info

Only two emojis are accepted. They will appear in order on new suggestions.

z/suggestion emoji example

Setting a cooldown for user suggestions

The suggestion cooldown command will configure a cooldown time in minutes for user suggestions.

z/suggestion cooldown 1         # 1 minute cooldown
z/suggestion cooldown disable # disable cooldowns

z/suggestion cooldown examples