Skip to content
All features

Moderation

Bans, mutes, warnings and notes that your whole team can see, with DMs that tell members why and how to appeal.

What you get

  • Bans, kicks, mutes and warningsTemporary bans and mutes, softbans, timeouts or a Muted role, warnings with auto-punish thresholds.
  • Cases, notes and mod logsEvery action becomes a numbered case. Edit reasons, add notes, review history.
  • Lockdown and channel locksLock one channel or a whole set in seconds, then unlock them together.
  • Ban appeals on the webMembers appeal through a form on kovu.gg. Approve or reject from Discord or the dashboard.
  • Purge with every filterClear by user, text, links, invites, images, bots, embeds and more, within Discord’s 14 days.
  • Mass role actionsAdd or remove a role for everyone, humans, bots or members of a role, with progress.

Modules

Each module turns on separately in the dashboard. Open one for its settings and a how-to.

Commands

Slash commands, with the prefix form (? by default) for servers that prefer typing.

/addemote

Managers

Add a custom emoji from a link, an image or another emoji

/addemote [source] [name] [image]?addemote <link|emoji> [name]
Options
source (optional)
Image link or custom emoji to copy (or attach an image)
name (optional)
Emoji name (2-32 letters, numbers or _)
image (optional)
Image to upload (PNG, JPG, GIF, WebP)

Also: ?addemoji

/addmod

Managers

Make a role a Kovu moderator role

/addmod <role>?addmod <role>
Options
role
Role that can use moderator commands

/addrole

Managers

Create a role

/addrole <name> [color] [hoist] [mentionable]?addrole <name> [color] [hoist]
Options
name
Role name
color (optional)
Colour, like #1d9e75
hoist (optional)
Show members separately in the list
mentionable (optional)
Let everyone @mention it

/announce

Managers

Post an announcement, optionally pinging a role

/announce <message> [channel] [role] [everyone] [embed] [title] [here]?announce [everyone|here|role @role] [#channel] <message> [--embed] [--title=…]
Options
message
What to announce
channel (optional)
Where to post it (default: the announcement channel in settings)
role (optional)
Role to ping
everyone (optional)
Ping @everyone
embed (optional)
Send as an embed
title (optional)
Embed title
here (optional)
Ping @here

/appeals

Everyone

Review ban appeals (moderators and appeal reviewers)

/appeals list [status] [user]/appeals view <appeal>/appeals approve <appeal> [reason]/appeals reject <appeal> [reason] [final]/appeals ask <appeal> <question>?appeals [list|view|approve|reject|ask] …
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 ban
ask appeal
The appeal number
ask question
Your question

Also: ?appeal

/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)

/delmod

Managers

Remove a role from the Kovu moderator roles

/delmod <role>?delmod <role>
Options
role
Moderator role to remove

/delnote

Moderators

Delete a note

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

/delrole

Managers

Delete a role

/delrole <role>?delrole <role>
Options
role
Role to delete

/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

/ignorechannel

Managers

Make Kovu ignore commands in a channel, or stop ignoring it

/ignorechannel [channel]?ignorechannel [#channel]
Options
channel (optional)
Channel (default: this one)

/ignored

Moderators

List the channels, roles and members Kovu ignores

/ignored?ignored

/ignorerole

Managers

Make Kovu ignore members with a role, or stop ignoring it

/ignorerole <role>?ignorerole <role>
Options
role
Role

/ignoreuser

Managers

Make Kovu ignore a member, or stop ignoring them

/ignoreuser <user>?ignoreuser <user>
Options
user
Member

/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)

/listmods

Moderators

List the moderator and manager roles

/listmods?listmods

/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

/mentionable

Managers

Let everyone @mention a role, or stop it

/mentionable <role> [enabled]?mentionable <role> [on|off]
Options
role
Role
enabled (optional)
On or off (leave empty to toggle)

/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)

/nick

Managers

Change Kovu's nickname in this server

/nick [nickname]?nick [nickname]
Options
nickname (optional)
New nickname (leave empty to reset)

/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

/purge

Moderators

Delete recent messages, optionally filtered

/purge [count] [filter] [text] [user] [message] [include_pinned]?purge [filter] [user|text|message id] [count] [--include-pinned]
Options
count (optional)
Messages to delete (up to 1000)
filter (optional)
Only delete messages that match (default: any)
text (optional)
Text for match, not, startswith and endswith
user (optional)
Only messages from this member
message (optional)
For "after": delete messages after this message (ID or link)
include_pinned (optional)
Also delete pinned messages

/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

/role

Managers

Give or take roles from one member or many

/role add <member> <role>/role remove <member> <role>/role toggle <member> <role>/role removeall <member>/role all <role> [action]/role humans <role> [action]/role bots <role> [action]/role in <in_role> <role> [action]/role status/role cancel?role
Options
add member
Member to change
add role
Role
remove member
Member to change
remove role
Role
toggle member
Member to change
toggle role
Role
removeall member
Member to change
all role
Role
all action (optional)
Add or remove the role (default: add)
humans role
Role
humans action (optional)
Add or remove the role (default: add)
bots role
Role
bots action (optional)
Add or remove the role (default: add)
in in_role
Members with this role are changed
in role
Role
in action (optional)
Add or remove the role (default: add)

/rolecolor

Managers

Change a role's colour

/rolecolor <role> <color>?rolecolor <role> <color>
Options
role
Role
color
Colour like #1d9e75, or "none" to remove it

Also: ?rolecolour

/rolename

Managers

Rename a role

/rolename <role> <name>?rolename <role> <new name>
Options
role
Role
name
New name

/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)

/setnick

Managers

Change a member's nickname

/setnick <member> [nickname]?setnick <member> [nickname]
Options
member
Member to rename
nickname (optional)
New nickname (leave empty to reset)

/slowmode

Moderators

Slow down a channel: shared, per member or Discord native

/slowmode channel [channel] [limit] [for]/slowmode user [channel] [limit] [for]/slowmode discord [channel] [limit] [for]/slowmode off [channel]/slowmode status [channel]?slowmode channel|user|discord [channel] [limit] [for] | off [channel] | status [channel]
Options
channel channel (optional)
Channel (default: this one)
channel limit (optional)
Time between messages, e.g. 5s, 2m (max 7d); "off" turns it off
channel for (optional)
Turn it off again after this long, e.g. 30m, 2h, 1d
user channel (optional)
Channel (default: this one)
user limit (optional)
Time between messages, e.g. 5s, 2m (max 7d); "off" turns it off
user for (optional)
Turn it off again after this long, e.g. 30m, 2h, 1d
discord channel (optional)
Channel (default: this one)
discord limit (optional)
Time between messages, e.g. 5s, 2m (max 6h); "off" turns it off
discord for (optional)
Turn it off again after this long, e.g. 30m, 2h, 1d
off channel (optional)
Channel (default: this one)
status channel (optional)
Channel (default: every slowed channel)

Also: ?slow

/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

Next areaAutomod and securityStop spam, raids and scams before your mods wake up.

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.