Suggestions

Set up and manage the suggestion system

Setting up

Run /setup create and pass the channel where members should post suggestions:

The setup command only asks for the suggestions channel. A private dashboard opens afterwards for the rest of the workflow:

  • Accepted, Denied, Planned, Implemented and Duplicate channels
  • custom labels and colors for those states
  • vote emojis and the optional thread button
  • automatic threads and rendered state history
  • a media channel and an optional log channel
  • an optional review queue, cooldown, membership-age requirement, duplicate check and per-member open-suggestion limit

Setup seeds two posts in the suggestions channel: a pinned how-to message and a locked example suggestion. The example is only a preview; it is not a real suggestion.

How a suggestion looks

Members can type a normal message in the channel, run /suggest, or use a persistent submit button posted with /setup submit-button. Aethor posts a Components V2 message with the author, public suggestion number, text, optional avatar, media gallery and vote controls.

Suggestion #42
Add a music channel so we can share tracks. 👍 12 #️⃣ 9 👎 3

The first and third buttons add or remove an upvote or downvote. The middle button shows the net score. The dashboard can replace the default vote emojis and add a thread button. With automatic threads enabled, Aethor starts Discussion: suggestion <number> automatically instead.

With a configured media channel, image and video attachments appear in the same card below the suggestion text. Multiple images or videos are displayed together in a gallery, while a file that cannot be rendered as image/video is not re-hosted as suggestion media. Older suggestions can still show the legacy Attachments link and (ID: <number>) footer until they are rebuilt by a moderation action or restore.

Authors cannot vote on their own suggestion. Clicking a vote control instead shows a private message with Delete YOUR SUGGESTION; deleting is permanent.

Reviewing suggestions

Use the private suggestion-manage message action or the suggestion-accept, suggestion-deny, suggestion-plan, suggestion-implement and suggestion-duplicate actions to move a suggestion into a resolved state. They are available from a message’s Apps menu; the dedicated state actions can also be run as commands with a suggestion number. A state channel is optional: when one is configured and posting is enabled, Aethor removes the previous status message and posts a locked copy in the new channel.

The suggestion is Accepted. Suggestion #27
srasar
Denied by tricked.
14 July 2026 at 20:56
Accepted by tricked.
14 July 2026 at 20:56 👍 12 #️⃣ 9 👎 3

The moderation response is private by default and says The suggestion is <state>.; moderators can opt into a public reply. With State history enabled, each transition is rendered in the latest card as a moderator note with its timestamp, as shown above. Status labels and colors are configurable. Suggestions can move directly between any states; applying the state they already have is the only rejected transition. suggestion-comment works in every state, not only while a suggestion is open.

suggestion-restore reopens a resolved suggestion in the main suggestions channel with its votes and media intact. It removes the old resolved-state message and creates a new Discord message, so the Discord message ID changes.

Review queue and submission controls

An optional per-setup queue lets staff approve, reject, inspect similar ideas or view author context before a suggestion is published. The setup dashboard also controls a member cooldown, minimum membership age, maximum number of open suggestions per member and exact duplicate-text rejection.

Message, slash-command and submit-button submissions all use these controls. See the review queue guide for the complete flow.

Finding and exporting

/suggestion list shows a paginated Components V2 list. It can filter by state, author, net-vote range, relative age and text, and sort by votes or creation date. /suggestion view shows one suggestion, while /suggestion leaderboard ranks open suggestions.

suggestion-export creates a CSV and is a premium-only command. suggestion-blacklist prevents a user from submitting suggestions; messages from blacklisted users are deleted without being turned into suggestions.

Media attachments

A suggestion can include up to eight image or video attachments. When a media channel is configured, Aethor keeps the original files on the suggestion message and also re-hosts them through the guild’s Aethor Media webhook so they survive deletion of the member’s original message. The dashboard’s media channel needs View Channel, Send Messages, Attach Files and Manage Webhooks.

If no media channel is configured, the suggestion still posts, but Aethor nudges administrators to choose one. Re-hosting is also subject to a 100 MiB per-guild daily in-memory budget, reset at UTC midnight or when the bot restarts.

The stalled-setup nudge

After 30 days with no suggestions, Aethor can remind the server to start using the channel. It sends at most two reminders and removes the latest reminder when the first real suggestion arrives.

Share your ideas
This channel has been quiet for a month. Post the first suggestion!

Changes since you set this up: recent Aethor updates Give feedback Read the Aethor docs

Permissions

In the suggestions channel and any state channel where Aethor should post, it needs:

  • Manage Messages
  • Embed Links
  • Manage Threads
  • Send Messages
  • Send Messages in Threads
  • Pin Messages
  • Read Message History
  • View Channel

The media channel additionally needs Attach Files and Manage Webhooks. Suggestion moderation commands default to members with Manage Messages; change their command permissions under Server Settings → Integrations → Aethor.

If the bot cannot read or manage the suggestions channel, messages are ignored instead of being converted.

Catches and limits

  • Free servers get one suggestion setup; premium servers get five.
  • /setup delete removes the setup and its stored suggestions. There is no undo.
  • Suggestions can be created from typed messages, /suggest, a persistent submit button, or staff message conversion.
  • User and channel rate limits are silent: after 60 suggestions per user or 120 per channel in four minutes, additional messages are ignored.
  • Only image and video attachments are handled, with a maximum of eight per suggestion. Storage re-hosting can be skipped after the 100 MiB daily budget is exhausted.
  • A missing media channel does not stop the suggestion from posting, but attachments may not remain available after Discord’s original CDN URL expires.
  • Resolved suggestions have locked vote controls. State transitions are unrestricted, but re-applying the current state is rejected.
  • State history is always stored. The dashboard’s State history switch controls whether the full transition chain is rendered on the latest status message.
  • Public suggestion posts, status messages and nudges use the server language. Private command responses use the user’s language.