Appeals

Off by default

Banned, muted and warned members appeal on kovu.gg through your forms. Each appeal lands in a channel or a forum post with Approve, Reject and Need more info, your staff talk with the member right there, and approving lifts the punishment.

On this page

Set it upLink to this section

Open the dashboard and pick your server. Sign in with Discord if you haven’t.
Find Appeals in the module list (press / to filter it, or ⌘K and type its name) and turn it on.
Go through the settings below. Simple mode shows the essentials; switch to Advanced for the rest.
Try it in Discord: /appeals. Staff can restrict or turn off each command in Commands.

Tips

Make one form per punishment: a long one for bans, a short one for mutes and warnings.
Post appeals in a forum: every appeal gets its own post, tagged with its status.
Have rejections block repeat appeals for a while, and lift blocks from the block list.

SettingsLink to this section

What you’ll find on the Appeals page of the dashboard. Settings marked Advanced only show in Advanced mode.

Appeal forms

Appeal formsSetting

Review

ReviewersRoles: Members with these roles can decide on appeals and talk with the member. Moderators always can. Approving lifts the punishment.
Messages in appeal threadsChoice: Automatic: what reviewers write in an appeal’s thread or forum post reaches the member, except messages starting with the staff prefix. Command: only /appeals reply does.
Staff prefixAdvancedText: Messages starting with this stay among staff (automatic sending only).
Rejections need a reasonAdvancedOn/off

Who can appeal and when

Wait after a rejectionDuration: How long after a rejection before they can appeal the same punishment again.
Appeals per punishmentAdvancedNumber: 0 means no limit.
Bans made outside KovuAdvancedOn/off: Accept appeals for bans without a Kovu case (made in Discord or by another bot). Share kovu.gg/appeal/<server id> with those members.

After a decision

Give an invite when a ban appeal is approvedOn/off: Kovu makes a one-use invite, valid for 7 days, and shows it to the member on their appeal page.
Invite channelAdvancedChannel: Where the invite leads. Default: the rules or system channel.
DM the memberAdvancedOn/off: Decisions and staff messages are also sent by DM. Banned members often share no server with Kovu, so the DM can fail; the appeal page always shows them.
Delete conversations automaticallyOn/off: Kovu deletes the messages between the member and the staff a while after the appeal is decided. Off: they stay.
Keep conversations for (days)Number: From 7 to 365 days after the decision. Default 90.

CommandsLink to this section

Each command works as a slash command and with your server’s prefix. Staff can restrict or turn off any of them in Commands.

/appeals

Everyone

Review appeals (moderators and appeal reviewers)

Also works as ?appeal

12 options

list status (optional): Which appeals (default: pending)
list user (optional): Only this member’s appeals
view appeal: The appeal number
approve appeal: The appeal number
approve reason (optional): Why (the member sees it)
reject appeal: The appeal number
reject reason (optional): Why (the member sees it)
reject final (optional): No further appeals for this punishment
ask appeal: The appeal number
ask question: Your question
reply message: Your message
reply appeal (optional): The appeal number (default: the appeal of this thread)

Examples

?appeals
?appeals approve 12 Welcome back
?appeals reject 12 Too soon --final
?appeals ask 12 Which account did you use before?
?appeals reply Thanks, we’re looking at it.

Ready to try Appeals?

Pick your server, turn it on and save. Changes reach Discord in seconds.

Open the dashboard