Commands
Key
| Key | Description |
|---|---|
< > | Required |
[ ] | Optional |
| | Means "or" |
bot | Refers to the Suggestions bot |
General Commands
| Command | Description | Guide |
|---|---|---|
| info | View bot information | click |
| stats | View bot statistics | click |
| suggest | Submit a new suggestion | click |
| configure user | Enable or disable suggestion DMs | click |
| view voters | View the voters on a given suggestion | click |
Staff Commands
These commands require a staff role or the Manage Server (MANAGE_GUILD) permission.
| Command | Description | Guide |
|---|---|---|
| approve | Approve a submitted suggestion | click |
| reject | Reject a submitted suggestion | click |
| resolve | Resolve a submitted suggestion with more resolution types | click |
| queue | Get the status of or view the guild's suggestions queue | click |
| clear | Remove a suggestion and any associated messages | click |
| note add | Add a note to a suggestion | click |
| note remove | Remove a note from a suggestion | click |
| setup | Configure the minimum requirements for the bot | click |
| configure guild | View and update various configuration settings of the bot | click |
| user block | Remove a users ability to create suggestions | click |
| user unblock | Re-add a users ability to create suggestions | click |
Command Information
Approve Command
/approve <sID> [response] [anonymously]
Approve a submitted suggestion via its suggestion ID (sID) with an optional response.
| Option | Description | Example | Required |
|---|---|---|---|
suggestion_id | The sID you wish to approve | /approve suggestion_id:lrt97z1s | true |
response | An optional response to add to the suggestion | /approve suggestion_id:lrt97z1s response:Expect this to be implemented in January 2024 | false |
anonymously | Hide your name in the response | /approve suggestion_id:lrt97z1s anonymously:True | false |
Configure Guild Command
/configure guild [menu]
View and update various configuration settings of the bot.
- You can view all settings by running
/configure guild - You can change the log channel settings using
/configure guild menu:Change Log Channel - You can configure the physical suggestions queue using
/configure guild menu:Configure Channel Based Suggestions Queue and Logs
Read more about configuring the bot via the guild configuration page.
Configure User Command
/configure user
Configure various user settings.
Read more about user configuration options via the user configuration page.
Clear Command
/clear <suggestion_id> [response] [anonymously]
If you need to remove a duplicate or bugged suggestion, you may use the /clear command to remove the suggestion and any associated messages in a channel. You may read more about it here.
| Option | Description | Example | Required |
|---|---|---|---|
suggestion_id | The sID you wish to clear | /clear suggestion_id:lrt97z1s | true |
response | An optional response to add to the suggestion | /clear suggestion_id:lrt97z1s response:This is duplicate to your last one. | false |
anonymously | Hide your name in the response | /clear suggestion_id:lrt97z1s anonymously:True | false |
Info Command
/info [support]
The info command displays the bot's authors, description, important links, and the bot version. Some of the most significant information is found here.
| Option | Description | Example | Required |
|---|---|---|---|
support | Set to receive info relevant to getting help | /info support:True | false |
Note Add Command
/note add <sID> [note] [anonymously]
Add a moderator note to a suggestion.
| Option | Description | Example | Required |
|---|---|---|---|
suggestion_id | The sID you wish to add note to | true | |
note | A note to add to the suggestion | /note add suggestion_id:lrt97z1s note:We cannot implement this feature at this time | true |
anonymously | Hide your name in the response | /note add suggestion_id:lrt97z1s anonymously:True | false |
Note Remove Command
/note remove <sID>
Remove a moderator note on a suggestion.
| Option | Description | Example | Required |
|---|---|---|---|
suggestion_id | The sID you wish to remove a note from | /note remove suggestion_id:lrt97z1s | true |
Queue Command
/queue <info|view>
The queue command displays information about the guild's queue (info) or displays the queue of suggestions (view).
| Option | Description | Example | Required |
|---|---|---|---|
info | View information about the guild's suggestions' queue | /queue info | true |
view | View the guild's suggestions' queue | /queue view | true |
Read more about how you can quality control suggestions in your server via the queue page.
Reject Command
/reject <sID> [response] [anonymously]
Reject a submitted suggestion via its suggestion ID (sID) with an optional response.
| Option | Description | Example | Required |
|---|---|---|---|
suggestion_id | The sID you wish to reject | /reject suggestion_id:lrt97z1s | true |
response | An optional response to add to the suggestion | /reject suggestion_id:lrt97z1s response:We cannot implement this feature at this time | false |
anonymously | Hide your name in the response | /reject suggestion_id:lrt97z1s anonymously:True | false |
Setup Command
/setup
An easy way to configure the minimum required items to use the bot. See /configure guild for full configuration options.
Stats Command
/stats
The stats command displays information regarding how many servers the bot is in, its uptime, bot version, library version, etc. Check here if you're a geek or just want to see how many servers the bot is in.
Suggest Command
/suggest
This command will allow the user to submit a new suggestion that will be sent to the set suggestions channel in the server.
When running this command a modal will appear with the following options.
| Option | Description | Required |
|---|---|---|
suggestion | Your suggestion | true |
image | An image to add to your suggestion | false |
anonymously | Submit your suggestion anonymously | false |
Optional options will not be present in the modal if your guild does not allow them.
View Voters Command
/view voters <suggestion_id> [filter]
This command will allow the user to view the voters on a particular suggestion. This command is an extension of being able to do the same thing through the [message context menu] [3] on a suggestion.
| Option | Description | Values | Example | Required |
|---|---|---|---|---|
suggestion_id | The suggestion you want to view voters for | /view voters suggestion_id:lrt97z1s | true | |
filter | The voters to view for this suggestion | - All voters - Up voters - Down voters | /view voters suggestion_id:lrt97z1s filter:Up voters | false |
Down below, you'll find different examples of how suggestions are displayed.
Running /view voters suggestion_id:lrt97z1s filter:Up voters will display all users who have upvoted the suggestion.
Running /view voters suggestion_id:lrt97z1s filter:Down voters will display all users who have downvoted the suggestion.
Running /view voters suggestion_id:lrt97z1s filter:All voters will display all users who have voted for the suggestion, both upvoters and downvoters.
User Block Command
/user block <suggestion_id>
This command will allow an administrator to block a specific user from submitting new suggestions. It takes the suggestion ID as input. Read more information on how this works here.
User Unblock Command
/user unblock [suggestion_id|user_id]
This command will allow an administrator to remove a specific user from the suggestion submission blocklist. It takes either a user ID or a suggestion ID as input. Read more information on how this works here.
| Option | Description | Example | Required |
|---|---|---|---|
suggestion_id | The suggestions ID you wish to reference | /user blocklist remove suggestion_id:lrt97z1s | false |
user_id | The users discord id | /user blocklist remove user_id:158063324699951104 | false |