# Suggestion operations

> Search, export and maintain suggestion setups

Use this page after a suggestion setup is running. It covers the operational features that do not belong in the member or review workflow.

<div class="not-prose doc-link-card-grid">
	<DocLinkCard
		href="/docs/suggestions"
		eyebrow="Overview"
		title="Configure the workflow"
		description="Set channels, states, voting, threads and review rules."
	/>
	<DocLinkCard
		href="/docs/suggestions/dashboard-suggestions"
		eyebrow="Dashboard"
		title="Manage the suggestion board"
		description="Browse, filter and resolve suggestions in the browser."
	/>
	<DocLinkCard
		href="/docs/suggestions/review-queue"
		eyebrow="Staff workflow"
		title="Review pending submissions"
		description="Hold suggestions for staff approval before publishing them."
	/>
	<DocLinkCard
		href="/docs/audit-log"
		eyebrow="Audit"
		title="Search and route audit activity"
		description="Use the central ledger and send selected events to different Discord channels."
	/>
</div>

## Search and export

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

<Cmd cmd="/suggestion leaderboard amount:3 order:asc" />

<discord-messages class="not-prose">
	<discord-message profile="aethor">
		<discord-embed slot="embeds" color="#41ebf4" author-name="Aethor suggestions" author-image="/logo-round.webp">
			<discord-embed-fields slot="fields">
				<discord-embed-field field-title="0: Suggestion 42 (9 votes)" inline inline-index="1">
					Add a music channel so members can share tracks and playlists, <a href="/docs/suggestions">link</a>
				</discord-embed-field>
				<discord-embed-field field-title="1: Suggestion 51 (6 votes)" inline inline-index="2">
					Host a monthly movie night chosen by community vote, <a href="/docs/suggestions">link</a>
				</discord-embed-field>
				<discord-embed-field field-title="2: Suggestion 63 (4 votes)" inline inline-index="1">
					Create a weekly question thread for the community, <a href="/docs/suggestions">link</a>
				</discord-embed-field>
			</discord-embed-fields>
		</discord-embed>
	</discord-message>
</discord-messages>

`suggestion-export` creates a CSV and is available on Premium servers. `suggestion-blacklist` prevents a member from submitting suggestions. Messages from a blacklisted member are deleted instead of becoming suggestions.

## Audit log

The full audit guide explains the dashboard ledger, multiple Discord routes,
the old suggestion-log migration and the staff cards sent to Discord. Start
there for setup instructions and screenshots: [Audit log and Discord logging](/docs/audit-log).

Suggestion routes can record submissions, edits, review decisions, state
changes, comments, deletions, restores and blacklist changes. Use a private
staff channel because suggestion cards identify the author and acting member.

## Media storage

A suggestion can include up to eight image or video attachments. With a media channel configured, Aethor keeps the original files on the suggestion message and re-hosts them through the guild's `Aethor Media` webhook so they survive deletion of the original member message.

The media channel needs **View Channel**, **Send Messages**, **Attach Files** and **Manage Webhooks**. Re-hosting uses a 100 MiB per-guild daily in-memory budget. The budget resets at UTC midnight or when the bot restarts.

Without a media channel, suggestions still post, but attachments may not remain available after Discord's original CDN URL expires.

## Stalled setup reminders

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

<discord-messages class="not-prose">
	<discord-message profile="aethor">
		<strong>Share your ideas</strong><br />
		This channel has been quiet for a month. Post the first suggestion!<br /><br />
		<small>Changes since you set this up: recent Aethor updates</small>
		<discord-action-row slot="components">
			<discord-button type="secondary"><BotEmoji name="feedback" /> Give feedback</discord-button>
			<discord-button type="secondary"><BotEmoji name="docs" /> Read the Aethor docs</discord-button>
		</discord-action-row>
	</discord-message>
</discord-messages>

## Limits and 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

Free servers get 1 suggestion setup. Premium servers get 5. `/setup delete` removes a setup and its stored suggestions; there is no undo.

Submissions can come from a typed message, `/suggest`, a persistent submit button or staff message conversion. Per-setup controls can add a member cooldown, minimum membership age, maximum open suggestions and exact duplicate-text rejection. Shared message limits can still ignore submissions after 60 suggestions from one user or 120 suggestions in one channel within four minutes.

Suggestion moderation actions use Manage Messages by default. You can change Discord command visibility under **Server Settings → Integrations → Aethor**, but Aethor's capability checks still decide whether an action runs.

Only image and video attachments are handled, with a maximum of eight per suggestion. State history is always stored. The dashboard's State history switch controls whether the transition chain is rendered on the latest status message.

> [!WARNING]
> Deleting a suggestion or setup is permanent. Export important data before using a delete action.

## Next steps

- [Create a suggestions channel](/docs/suggestions/create-suggestions-channel)
- [Approve and resolve suggestions](/docs/suggestions/approve-suggestions)
- [Suggestion messages and notifications](/docs/suggestions/suggestion-notifications)