Skip to content

Modmail

Off by default

Members DM Kovu to reach your staff in a private conversation. Staff answer from a channel or thread, by name or anonymously, and closed conversations can keep a transcript.

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

Tips

  • Use /modmail contact to message a member first. Kovu tells you if they stopped your server’s messages.
  • Every DM Kovu sends for your staff names who sent it (the staff member, or your anonymous name) and ends with how to stop it. A member who runs /modmail stop gets no more messages from your staff until they run /modmail allow, and can still open a conversation themselves.

SettingsLink to this section

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

Where conversations open

Conversations open asChoice
CategoryCategory
A private text channel per conversation, in this category. Only staff roles (or the category’s permissions) can see them.
Staff channelChannel
A thread per conversation in this text channel, or a post in this forum. Keep the channel staff-only.
Staff rolesRoles
They can see conversations and reply. Managers always can.
Moderators are staffAdvancedOn/off
Members with a mod role or moderation permissions can reply too.
Ping when a conversation opensAdvancedRoles

Replies

Sending repliesChoice
Automatic: everything staff write in the conversation goes to the member, except notes starting with the note prefix. Command: only /modmail reply is sent.
Note prefixAdvancedText
Messages starting with this stay in the server (automatic sending only).
Anonymous repliesOn/off
The member sees the name below instead of who answered. /modmail reply can override it per message.
Anonymous nameAdvancedText
GreetingText with variables
Sent to the member when a conversation opens.
Closing messageAdvancedText with variables
Sent to the member when staff close the conversation. {reason} is the reason.

Logs and transcripts

Log channelChannel
Opened and closed conversations, with the transcript link.
Save transcriptsOn/off
Keep an HTML copy of every conversation when it closes. Staff read it on kovu.gg.
Members can read their transcriptAdvancedOn/off
The closing DM links to it. It shows internal notes and who answered, even anonymous replies.
Delete transcripts automaticallyOn/off
Kovu deletes each transcript a while after it was saved. Off: transcripts stay until your staff delete them.
Keep transcripts for (days)Number
From 7 to 365 days after the conversation’s transcript was saved. Default 90.

LimitsAdvanced

Open conversations at onceNumber
New ones wait until staff close some.
Wait after a conversation closesDuration
Before the same member can open another. 0: right away.
Minimum account ageDuration
Newer Discord accounts can’t open conversations. 0: any age.

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.

?areply

Everyone

Answer the member anonymously in this modmail conversation

?areply <message>
1 option
message (optional)
What to send
Examples
  • ?areply We’ll look into it.

/modmail

Everyone

Contact the staff, or answer members as staff

/modmail open <message>/modmail reply [message] [anonymous] [file]/modmail snippet <name> [anonymous]/modmail close [reason] [silent]/modmail contact <user> [message]/modmail block <user> [duration] [reason]/modmail unblock <user>/modmail info/modmail stop/modmail allow?modmail [open|reply|snippet|close|contact|block|unblock|info|stop|allow] …

Also works as ?mm

14 options
open message
What to send
reply message (optional)
What to send
reply anonymous (optional)
Hide your name
reply file (optional)
A file to send
snippet name
The snippet
snippet anonymous (optional)
Hide your name
close reason (optional)
Why (the member sees it unless silent)
close silent (optional)
Don’t tell the member
contact user
The member
contact message (optional)
What to send
block user
The member
block duration (optional)
How long (default: until unblocked)
block reason (optional)
Why (staff only)
unblock user
The member
Examples
  • ?modmail open I need help with my order
  • ?modmail close Sorted, thanks!
  • ?modmail snippet rules
  • ?modmail block @spammer 7d

?reply

Everyone

Answer the member in this modmail conversation

?reply <message>
1 option
message (optional)
What to send
Examples
  • ?reply Thanks, we’re on it!

?snippet

Everyone

Send a saved modmail reply

?snippet <name>
1 option
name
The snippet
Examples
  • ?snippet rules

Ready to try Modmail?

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

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.