Skip to content
Add to DiscordSign in

Moderation

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

Add to DiscordSet it up

All features

Every ban comes with a way back

The member gets a DM with the reason and a link to appeal. Their appeal lands in your appeals channel with the case attached, and your team decides there or in the dashboard.

Every mod action, logged as a case, with the reason and the fix one command away.

Bans, kicks, mutes and warnings
Temporary bans and mutes, softbans, timeouts or a Muted role, warnings with auto-punish thresholds.
Cases, notes and mod logs
Every action becomes a numbered case. Edit reasons, add notes, review history.
Lockdown and channel locks
Lock one channel or a whole set in seconds, then unlock them together.
Ban appeals on the web
Members appeal through a form on kovu.gg. Approve or reject from Discord or the dashboard.
Purge with every filter
Clear by user, text, links, invites, images, bots, embeds and more, within Discord’s 14 days.
Mass role actions
Add 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)
    Color, 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 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 reply <message> [appeal]?appeals [list|view|approve|reject|ask|reply] …
    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)

    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 or add proof to it

    /case view <case> [server]/case proof <case> [proof]?case <case> [linked server] | proof <case> [proof]
    Options
    view case
    Case number
    view server (optional)
    A linked server, to look up its case instead (read-only)
    proof case
    Case number
    proof proof (optional)
    Text or a message link (empty = clear it)

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

  • /mass

    Managers

    Ban, kick, mute or warn many members at once, after a preview

    /mass ban <users>/mass kick <users>/mass mute <users>/mass warn <users>/mass by-name <action> <text> [match]/mass by-time <action> <kind> <within>/mass status/mass cancel?mass ban|kick|mute|warn <users…> | by-name <action> <text> | by-time <action> <kind> <within>
    Options
    ban users
    Members: mentions or user IDs separated by spaces
    kick users
    Members: mentions or user IDs separated by spaces
    mute users
    Members: mentions or user IDs separated by spaces
    warn users
    Members: mentions or user IDs separated by spaces
    by-name action
    What to do to each member
    by-name text
    Text to look for in usernames, display names and nicknames
    by-name match (optional)
    How the name must match (default: contains)
    by-time action
    What to do to each member
    by-time kind
    Look at when they joined or when their account was made
    by-time within
    How far back, like 10m or 2h (up to 30 days)

  • ?massban

    Managers

    Prefix form of /mass ban

    ?massban <users…> [duration] [reason]
    Options
    users
    Members: mentions or user IDs separated by spaces

  • ?masskick

    Managers

    Prefix form of /mass kick

    ?masskick <users…> [reason]
    Options
    users
    Members: mentions or user IDs separated by spaces

  • ?massmute

    Managers

    Prefix form of /mass mute

    ?massmute <users…> [duration] [reason]
    Options
    users
    Members: mentions or user IDs separated by spaces

  • ?masswarn

    Managers

    Prefix form of /mass warn

    ?masswarn <users…> [reason]
    Options
    users
    Members: mentions or user IDs separated by spaces

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

  • ?nameban

    Managers

    Prefix form of /mass by-name with ban (-f for a full name match)

    ?nameban <text> [-f]
    Options
    text
    Text to look for in names

  • /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 color

    /rolecolor <role> <color>?rolecolor <role> <color>
    Options
    role
    Role
    color
    Color 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)

  • ?timeban

    Managers

    Prefix form of /mass by-time with ban: members who joined within a time

    ?timeban <within> [joined|created]
    Options
    within
    How far back, like 10m
    kind (optional)
    joined (default) or created

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

Analytics on Kovu

We use Google Analytics to see which pages and features get used. It never gets your Discord ID, server names or messages. No ads, and we don’t sell your data. Read our Cookie Policy.