Skip to content
Sign in
Help centerModeration

Moderation

On by default

Ban, kick, mute and warn with reasons, durations and a numbered case for every action. Members get a DM with the reason (and an appeal link for bans), and your mod log keeps the full history.

Set it up

  1. Open the dashboard and pick your server. Sign in with Discord if you haven’t.

  2. Find Moderation in the sidebar. It’s already on in new servers.

  3. Go through the settings below. Simple mode shows the essentials; switch to Advanced for the rest.

  4. Try it in Discord: /ban. Staff can restrict or turn off each command in Commands.

Tips

  • Pick a mod log channel so every case lands in one place.
  • Set autopunish rules, such as a 1-hour mute at 3 warnings.
  • Use `/case` and `/reason` to fix a reason after the fact; the log message updates too.

Settings

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

General

Mod log channel
ChannelEvery ban, kick, mute and warning is posted here as a case.
Report channelAdvanced
ChannelWhere /report and the Report message action go. Leave empty to use the mod log channel.
Show the reason in repliesAdvanced
On/off

Mutes

Mute with
ChoiceTimeout uses Discord’s built-in timeout. A Muted role also works in voice.
Muted role
RoleUsed in role mode. Kovu can create and set it up for you.
Remove other roles while mutedAdvanced
On/offRoles come back when the mute ends.
Default mute lengthAdvanced
DurationUsed when no duration is given. Empty = until unmuted.

Direct messagesAdvanced

What members are told when they are punished.

DM members when they are banned
On/off
DM members when they are softbanned
On/off
DM members when they are kicked
On/off
DM members when they are muted
On/off
DM members when they are warned
On/off
Include the reason
On/off
Name the moderator
On/off
Add the appeal link to ban DMs
On/off
Appeal link
TextLeave empty to use Kovu's appeal form when the Appeals module is on.

BansAdvanced

Keep messages when banning
On/off
Delete messages from the last
DurationUp to 7 days. Used when messages are not kept.
Softban deletes messages from the last
Duration

Autopunish

Autopunish
SettingPunish members automatically when they reach a number of warnings.

Lockdown

Lockdown channels
ChannelsChannels locked and unlocked together by lockdown.
Lock messageAdvanced
Text with variablesPosted when lock or lockdown closes a channel (unless the command gives its own). Variables: {channel}, {duration}, {moderator}. Empty = no message.
Unlock messageAdvanced
Text with variablesPosted when a channel opens again. Variables: {channel}, {moderator}. Empty = no message.

Custom repliesAdvanced

Ban reply
Text with variablesLeave empty for the default. Variables: {user}, {reason}, {duration}, {case}.
Unban reply
Text with variablesLeave empty for the default. Variables: {user}, {reason}, {duration}, {case}.
Softban reply
Text with variablesLeave empty for the default. Variables: {user}, {reason}, {duration}, {case}.
Kick reply
Text with variablesLeave empty for the default. Variables: {user}, {reason}, {duration}, {case}.
Mute reply
Text with variablesLeave empty for the default. Variables: {user}, {reason}, {duration}, {case}.
Unmute reply
Text with variablesLeave empty for the default. Variables: {user}, {reason}, {duration}, {case}.
Warn reply
Text with variablesLeave empty for the default. Variables: {user}, {reason}, {duration}, {case}.

Commands

/ban

Moderators

Ban a member or user, optionally for a while

/ban <user> [duration] [reason] [delete_days] [preserve_messages] [no_appeal]?ban [save] <user> [duration] [reason] [--delete-days 0-7] [--no-appeal]
Options
user
Member or user ID to ban
duration (optional)
How long, like 7d (leave empty for a permanent ban)
reason (optional)
Why (shown in the mod log and audit log)
delete_days (optional)
Days of their messages to delete (0-7)
preserve_messages (optional)
Keep their messages (same as "ban save")
no_appeal (optional)
Leave the appeal link out of the DM

/case

Moderators

Show a moderation case

/case <case>?case <case>
Options
case
Case number

/clean

Moderators

Delete Kovu's recent replies and the commands that triggered them

/clean [count]?clean [count]
Options
count (optional)
How many messages to delete (default 50)

Also: ?cleanup

/clearnotes

Moderators

Delete every note on a member

/clearnotes <user>?clearnotes <user>
Options
user
Member or user ID

/clearwarn

Moderators

Clear all of a member's warnings

/clearwarn <user>?clearwarn <user>
Options
user
Whose warnings to clear

Also: ?clearwarns

/deafen

Moderators

Server-deafen a member in voice

/deafen <user> [reason]?deafen <user> [reason]
Options
user
Member to deafen
reason (optional)
Why (shown in the mod log and audit log)

/delnote

Moderators

Delete a note

/delnote <user> <note>?delnote <user> <note>
Options
user
Member or user ID
note
Note number (from notes)

/delwarn

Moderators

Delete a warning by its case number

/delwarn <case>?delwarn <case>
Options
case
Case number of the warning

Also: ?deletewarn, ?removewarn

/diagnose

Managers

Explain why a command or module isn't working in this channel

/diagnose [target]?diagnose [command or module]
Options
target (optional)
Command or module to check (empty = overview)

/duration

Moderators

Change how long a tempban, mute or temporary role lasts

/duration <case> <duration>?duration <case> <duration>
Options
case
Case number of the punishment
duration
New length from when it started, like 2h, or "permanent"

/editnote

Moderators

Edit a note

/editnote <user> <note> <text>?editnote <user> <note> <text>
Options
user
Member or user ID
note
Note number (from notes)
text
New text

/ignored

Moderators

List the channels, roles and members Kovu ignores

/ignored?ignored

/kick

Moderators

Kick a member from the server

/kick <user> [reason]?kick <user> [reason]
Options
user
Member to kick
reason (optional)
Why (shown in the mod log and audit log)

/lock

Moderators

Stop @everyone from sending messages in a channel

/lock [channel] [duration] [message]?lock [channel] [duration] [message]
Options
channel (optional)
Channel to lock (empty = this one)
duration (optional)
Unlock automatically after this long, like 30m
message (optional)
Message posted in the channel

/lockdown

Moderators

Lock or unlock every lockdown channel at once

/lockdown start [duration] [message]/lockdown end [message]?lockdown [duration] [message] | end [message]
Options
start duration (optional)
End the lockdown automatically after this long
start message (optional)
Message posted in each channel
end message (optional)
Message posted in each channel

/members

Moderators

List the members who have a role

/members <role>?members <role>
Options
role
Role to list

Also: ?inrole

/moderations

Moderators

List active timed punishments (tempbans, mutes, temporary roles)

/moderations [user]?moderations [user]
Options
user (optional)
Only this member

/modlogs

Moderators

Show the moderation history of a member

/modlogs <user>?modlogs <user>
Options
user
Member or user ID

Also: ?modlog

/modstats

Moderators

Moderation stats for a moderator or the whole server

/modstats [moderator]?modstats [moderator]
Options
moderator (optional)
Moderator (empty = everyone)

/mute

Moderators

Mute a member (timeout or the Muted role)

/mute <user> [duration] [reason]?mute <user> [duration] [reason]
Options
user
Member to mute
duration (optional)
How long, like 10m or 1h (empty = the default length)
reason (optional)
Why (shown in the mod log and audit log)

/note

Moderators

Add a private moderator note to a member

/note <user> <text>?note <user> <text>
Options
user
Member or user ID
text
The note

/notes

Moderators

Show the moderator notes on a member

/notes <user>?notes <user>
Options
user
Member or user ID

/reason

Moderators

Change a case's reason (updates the mod log too)

/reason <case> <reason>?reason <case> <reason>
Options
case
Case number
reason
New reason

/report

Everyone

Report a member to the moderators

/report <user> <reason>?report <user> <reason>
Options
user
Who you are reporting
reason
What happened

/rolepersist

Moderators

Keep a role on a member even if they leave and rejoin (toggles)

/rolepersist <user> <role> [reason]?rolepersist <user> <role> [reason]
Options
user
Member or user ID
role
Role to keep
reason (optional)
Why (shown in the mod log and audit log)

/softban

Moderators

Ban and unban a member to delete their recent messages

/softban <user> [reason] [delete_days]?softban <user> [reason]
Options
user
Member to softban
reason (optional)
Why (shown in the mod log and audit log)
delete_days (optional)
Days of their messages to delete (0-7)

/temprole

Moderators

Give a member a role for a limited time

/temprole <user> <duration> <role> [reason]?temprole <user> <duration> <role> [reason]
Options
user
Member who gets the role
duration
How long, like 1d
role
Role to give
reason (optional)
Why (shown in the mod log and audit log)

/unban

Moderators

Lift a ban

/unban <user> [reason]?unban <user> [reason]
Options
user
User or user ID to unban
reason (optional)
Why (shown in the mod log and audit log)

/undeafen

Moderators

Remove a server deafen

/undeafen <user> [reason]?undeafen <user> [reason]
Options
user
Member to undeafen
reason (optional)
Why (shown in the mod log and audit log)

/unlock

Moderators

Unlock a locked channel

/unlock [channel] [message]?unlock [channel] [message]
Options
channel (optional)
Channel to unlock (empty = this one)
message (optional)
Message posted in the channel

/unmute

Moderators

Unmute a member

/unmute <user> [reason]?unmute <user> [reason]
Options
user
Member to unmute
reason (optional)
Why (shown in the mod log and audit log)

/warn

Moderators

Warn a member

/warn <user> [reason]?warn <user> [reason]
Options
user
Member to warn
reason (optional)
Why (shown in the mod log and audit log)

/warnings

Moderators

List a member's warnings, or the latest warnings in the server

/warnings [user]?warnings [user]
Options
user (optional)
Whose warnings (empty = everyone)

Also: ?warns

Related modules

Appeals Manager Slowmode

Ready to try Moderation?

Open the dashboard

Cookies on Kovu

We use essential cookies to sign you in and keep Kovu secure. With your OK we also remember preferences like your theme. No ads, no tracking, and we don’t sell your data. Read our Cookie Policy.