/addemote
ManagersAdd 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
ManagersMake a role a Kovu moderator role
/addmod <role>?addmod <role>
Options
- role
- Role that can use moderator commands
/addrole
ManagersCreate 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
ManagersPost 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
EveryoneReview 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
ModeratorsBan 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
ModeratorsShow a moderation case
/case <case>?case <case>
Options
- case
- Case number
/clean
ModeratorsDelete 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
ModeratorsDelete every note on a member
/clearnotes <user>?clearnotes <user>
Options
- user
- Member or user ID
/clearwarn
ModeratorsClear all of a member's warnings
/clearwarn <user>?clearwarn <user>
Options
- user
- Whose warnings to clear
Also: ?clearwarns
/deafen
ModeratorsServer-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
ManagersRemove a role from the Kovu moderator roles
/delmod <role>?delmod <role>
Options
- role
- Moderator role to remove
/delnote
ModeratorsDelete a note
/delnote <user> <note>?delnote <user> <note>
Options
- user
- Member or user ID
- note
- Note number (from notes)
/delrole
ManagersDelete a role
/delrole <role>?delrole <role>
Options
- role
- Role to delete
/delwarn
ModeratorsDelete a warning by its case number
/delwarn <case>?delwarn <case>
Options
- case
- Case number of the warning
Also: ?deletewarn, ?removewarn
/diagnose
ManagersExplain 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
ModeratorsChange 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
ModeratorsEdit 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
ManagersMake Kovu ignore commands in a channel, or stop ignoring it
/ignorechannel [channel]?ignorechannel [#channel]
Options
- channel (optional)
- Channel (default: this one)
/ignored
ModeratorsList the channels, roles and members Kovu ignores
/ignored?ignored
/ignorerole
ManagersMake Kovu ignore members with a role, or stop ignoring it
/ignorerole <role>?ignorerole <role>
Options
- role
- Role
/ignoreuser
ManagersMake Kovu ignore a member, or stop ignoring them
/ignoreuser <user>?ignoreuser <user>
Options
- user
- Member
/kick
ModeratorsKick 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
ModeratorsList the moderator and manager roles
/listmods?listmods
/lock
ModeratorsStop @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
ModeratorsLock 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
ModeratorsList the members who have a role
/members <role>?members <role>
Options
- role
- Role to list
Also: ?inrole
/mentionable
ManagersLet 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
ModeratorsList active timed punishments (tempbans, mutes, temporary roles)
/moderations [user]?moderations [user]
Options
- user (optional)
- Only this member
/modlogs
ModeratorsShow the moderation history of a member
/modlogs <user>?modlogs <user>
Options
- user
- Member or user ID
Also: ?modlog
/modstats
ModeratorsModeration stats for a moderator or the whole server
/modstats [moderator]?modstats [moderator]
Options
- moderator (optional)
- Moderator (empty = everyone)
/mute
ModeratorsMute 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
ManagersChange Kovu's nickname in this server
/nick [nickname]?nick [nickname]
Options
- nickname (optional)
- New nickname (leave empty to reset)
/note
ModeratorsAdd a private moderator note to a member
/note <user> <text>?note <user> <text>
Options
- user
- Member or user ID
- text
- The note
/notes
ModeratorsShow the moderator notes on a member
/notes <user>?notes <user>
Options
- user
- Member or user ID
/purge
ModeratorsDelete 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
ModeratorsChange a case's reason (updates the mod log too)
/reason <case> <reason>?reason <case> <reason>
Options
- case
- Case number
- reason
- New reason
/report
EveryoneReport a member to the moderators
/report <user> <reason>?report <user> <reason>
Options
- user
- Who you are reporting
- reason
- What happened
/role
ManagersGive 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
ManagersChange 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
ManagersRename a role
/rolename <role> <name>?rolename <role> <new name>
Options
- role
- Role
- name
- New name
/rolepersist
ModeratorsKeep 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
ManagersChange a member's nickname
/setnick <member> [nickname]?setnick <member> [nickname]
Options
- member
- Member to rename
- nickname (optional)
- New nickname (leave empty to reset)
/slowmode
ModeratorsSlow 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
ModeratorsBan 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
ModeratorsGive 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
ModeratorsLift 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
ModeratorsRemove 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
ModeratorsUnlock 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
ModeratorsUnmute 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
ModeratorsWarn 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
ModeratorsList a member's warnings, or the latest warnings in the server
/warnings [user]?warnings [user]
Options
- user (optional)
- Whose warnings (empty = everyone)
Also: ?warns