Modmail Docs
GitHubDonateSetupDiscord Server
  • Introduction
  • Installation
    • Local hosting / VPS
      • Windows
      • MacOS
      • Docker
      • Ubuntu
      • Debian
      • Fedora
      • Alma Linux
      • Logviewer
      • Patreon logviewer
    • Railway
    • Heroku
    • Community Guides
  • Setting up auto-restart
  • Updating
  • Getting Started
  • Usage
    • Plugins
    • Configuration
    • Permissions
  • Frequently Asked Questions
  • OLD DOCS
    • Installation
    • Installation (continued)
    • Color Names
    • Configuration Variables (Config Vars)
    • Configure Modmail and Logviewer
    • Frequently Asked Questions
    • Modmail Usage
    • Updating
    • Video Tutorials
Powered by GitBook
On this page
  • What is Modmail used for?
  • Features
  • Installation
  • Supporting the project
  • Contributing
  • Next steps

Was this helpful?

Edit on GitHub

Introduction

https://github.com/modmail-dev/modmail

NextInstallation

Last updated 1 year ago

Was this helpful?

Modmail is a self-hosted Discord bot for your server. It works similar to 's Modmail—both in functionality and purpose. It serves as a shared inbox for server staff to communicate with their users in a seamless way.

This bot is free for everyone and always will be. If you like this project and would like to show your appreciation, you can support us on , cool benefits included!

What is Modmail used for?

When a member sends a direct message to Modmail, the bot will create a channel (we call it a "thread") into a designated category. All further DM messages will automatically relay to that channel, then any available staff can respond within the channel. Compared to ticketing bots, Modmail allows easier and more organised discussions among staff.

An example of a Modmail thread.

Features

Highly customisable

  • Changeable bot status, prefix, category, log channel, etc.

  • Versatile command permission system.

  • Interface elements (color, responses, reactions, etc.).

  • Snippets and command aliases.

  • Minimum duration for accounts to be created before allowed to contact Modmail (account_age).

  • Minimum length for members to be in the guild before allowed to contact Modmail (guild_age).

Advanced logging functionality

  • When you close a thread, Modmail will generate a log link and post it to your log channel.

  • Native Discord dark-mode feel.

  • Markdown/formatting support.

  • See past logs of a user with ?logs.

  • Searchable by text queries using ?logs search.

Robust implementation

  • Ease of installation: you can get your Modmail bot running in under 10 minutes!

  • Schedule tasks in human time, e.g. ?close in 2 hours silently.

  • Editing and deleting messages are synced.

  • Support for the diverse range of message contents (multiple images, files).

  • Paginated commands interfaces via reactions.

This list is ever-growing thanks to active development by our exceptional contributors. See a full list of available commands by using the ?help command.

Installation

Supporting the project

Contributing

Next steps

Throughout this documentation when we're referring to bot commands, we will assume the prefix of the bot to be ? and will display them like in this example: ?help. Optional arguments will be enclosed in square brackets: Example: ?close [time] [reason] [silently] Required arguments will be enclosed in angle brackets: Example: ?contact <user>

Our Logviewer will save the threads so your staff can view previous threads through their corresponding log link. Here is an .

Discord authentication-protected logs ().

Visit our for detailed instructions on setting up Modmail for your server.

You have various options to help the project. Giving this repository a star is greatly appreciated. You can also help people that have trouble setting up Modmail at our .

If you like to show your appreciation, consider supporting us on !

Support Modmail with your contributions! Whether it be improvements to the documentation or new functionality, please feel free to make the change. Check out our before you get started.

Read about .

Become familiar with .

example
Patreon-only feature
installation page
Discord server
Patreon
contributing guidelines
installing Modmail
Modmail commands and functionalities
Reddit
Patreon