Moderation — Settings

The configuration hub for the entire moderation system — who can run commands, where logs and reports are posted, what each action notifies, custom message templates, and default durations.

Overview

The Moderation → Settings page in the guild dashboard is the single place where you configure the moderation system. It has five sections:

1. Who can run moderation commands — role access and the log channel.
2. Reports — the reports channel and report DM notification toggles.
3. Notifications — per-command DM offender and public message mode.
4. Custom public messages — per-command custom message templates (Premium).
5. Default action options — default durations and purge days for ban, mute, and timeout.

This page must be saved at least once before any moderation command works. See the setup requirement on the Overview page.

Who can configure

Only the server owner, Mokito managers, and Mokito admins can access and save the Settings page. Moderators and support team cannot.

Who can run moderation commands

By default, only the server owner, Mokito managers, and users with Discord's Administrator permission can run moderation commands. This section lets you extend access to additional roles in your server.

Adding roles

Type a role name in the Add roles field to search your server's roles. Selecting a role adds it as a chip below the field. Click the on any chip to remove it. Any user who holds one of the listed roles — in addition to the owner, managers, and Administrators — will be able to run moderation commands in Discord.

If the role list is empty, refresh your server's data from the guild overview page first so Mokito knows about your roles.

Moderation log channel

The moderation log channel field lets you pick a text or announcement channel where every moderation action posts a structured, color-coded embed. The embed includes the offender, action, reason, duration, moderator, and timestamp. Leave the field empty to disable the log channel entirely — actions will still be recorded in the web-panel logs, just not posted to Discord.

See the Overview → Moderation log channel section for the color mapping per action.

Reports channel

The reports channel is where user-submitted reports are posted when a member uses /report. Each report generates an embed with the reported user, the reporter, the reason, any evidence, and a link back to the web-panel report detail page. Leave the field empty to disable reports entirely — /report will reply that reports are not configured.

See the Reports page for the full report workflow.

Report DM notifications Premium

Two optional DM notifications for user-generated reports, both gated on Mokito Premium:

On a free server, both toggles are disabled and a Premium lock appears. Your toggle preferences are still saved and will activate the moment you upgrade to Premium — no reconfiguration needed.

DM reported user

When enabled, the reported user receives a DM like:

An anonymous moderation report has been created about you in **Your Server**. The moderation team may reach out at a later time to ask questions. Report ID: `a1b2c3d4-...`.

DM reporting user

When enabled, the reporting user receives a DM on creation:

Your moderation report in **Your Server** has been created. The moderation team will review it. Report ID: `a1b2c3d4-...`.

And again when the report is resolved or reopened:

Your moderation report in **Your Server** has been resolved. Report ID: `a1b2c3d4-...`.

Per-command notifications

The Notifications section shows a row for each of the 8 moderation actions (ban, unban, kick, mute, unmute, timeout, untimeout, warn). For each action, you configure two things independently:

DM offender toggle

An on/off toggle (X / ✓). When on, Mokito sends a private DM to the punished user with the action, server name, duration (if applicable), and reason. When off, no DM is sent.

For /unban, this toggle is marked N/A — unbanned users are not in the server and cannot be DMed. For /ban and /kick, the DM is sent before the user is removed.

By default, DM offender is on for every action except unban.

Public message mode

A dropdown with five options for what (if anything) to post in the channel where the command was invoked:

By default, ban, unban, kick, mute, and timeout are set to Public — action. Unmute, untimeout, and warn are set to Disabled. Change any of them to suit your server's transparency preferences.

Custom public messages Premium

When you select Public — custom for an action, Mokito uses the custom message template you write for that action instead of the built-in format. This is a Mokito Premium feature — on a free server, the custom option is disabled in the dropdown and the textareas are locked.

Each of the 8 actions has its own textarea. The default template for every action is:

The {offender} has been {action} for {reason} - {length} at {time} by {moderator}

Edit it to say whatever you want. The placeholders are replaced with real values when the message is posted.

Placeholders

Default action options

Three actions have configurable defaults that apply when a moderator omits an option in Discord:

Ban purge days

For /ban, you can set the number of days of previous messages to purge when the ban is applied. The value can be 0 (no purge) to 7 days. The default is 7 days. This is passed to Discord as the delete_message_days parameter on the ban request.

Mute & Timeout duration

For /mute and /timeout, you can set a default duration that applies when the moderator does not provide a duration argument. Each has a numeric value and a unit dropdown (Minutes, Hours, Days, Weeks).