User-generated reports — any member can flag a user to the moderation team with /report, and staff review, annotate, and resolve them from the web panel.
The Reports system lets any member of your server flag another user for the moderation team's attention. A member runs /report in Discord with the user, a reason, and optional evidence. Mokito creates a report, posts an embed to the reports channel, and adds the report to the Moderation → Reports page in the web panel. Staff can then review the report, add internal notes, upload attachments, and resolve or reopen it.
Reports are never deleted. They remain on the Reports page as a permanent record, even after they are resolved.
Owners, managers, Mokito admins, and moderators can view the Reports page and all report details. Moderators can add notes, upload attachments, download attachments, resolve, and reopen reports — the same actions as owners and managers. Support team members cannot access the Reports page.
Any guild member — not just moderators — can use /report. It is intentionally open: reporting is a member-facing tool, not a privileged moderation action. The response is ephemeral, so only the reporter sees it.
/report user:@badactor reason:Harassment evidence:https://discord.com/channels/.../123Mokito responds (ephemeral):
Your report has been submitted and forwarded to the moderation team.| Argument | Type | Required | Description |
|---|---|---|---|
user | User (@mention) | Yes | The user you want to report. |
reason | String | Yes | Why you are reporting the user. Be specific. |
evidence | String | No | Optional evidence — message links, message IDs, or a description of where to find the evidence. Truncated to 1000 characters in the Discord embed. |
The embed posted to the reports channel includes the report ID, server name, reported user, reporter, reason, evidence, and a link to the web-panel report detail:
New moderation report · #a1b2c3d4-...
A member submitted a moderation report in **Your Server**.
Reported user: @badactor
Reported by: @concernedmember (Concerned Member)
Reason: Harassment
Evidence: https://discord.com/channels/.../123
View report: https://mokito.bippymiester.dev/dashboard/guilds/.../moderation/reports/a1b2c3d4-...
Report ID: a1b2c3d4-...| Condition | Ephemeral response |
|---|---|
| Reports channel not configured | "Reports are not configured for this server." |
| No user provided | "Please provide a user to report." |
| No reason provided | "Please provide a reason for the report." |
| Moderation settings not configured | "Moderation commands are not set up for this server yet..." |
| Command disabled | "The **/report** command is currently disabled in this server." |
The Moderation → Reports page shows a paginated table (20 per page, newest first) of every report in the server. Each row shows:
| Column | What it shows |
|---|---|
| Report ID | The UUID of the report. |
| Reported user | The user who was reported, with avatar + display name. |
| Reported by | The user who filed the report, with avatar + display name. |
| Reason | A short preview of the reason. |
| Status | Open or Resolved. |
| Created | When the report was filed. |
| Action | A "View" link to the report detail page. |
Click any report to open its detail page. The detail is laid out in two columns: the main details on the left, and the action sidebar on the right.
Staff can add internal notes to any report. Notes are visible only to dashboard users — the reported and reporting users never see them. Each note records the author's display name and the timestamp. Use notes to coordinate with other staff, record investigation findings, or document why a report was resolved or reopened.
To add a note, type in the Add a note textarea and click Add note. Notes appear immediately in the list above the form.
Staff can upload files to a report as evidence. Supported file types: PNG, JPG, JPEG, GIF, WebP, PDF, TXT, and MD. Maximum file size: 5 MB. Upload by clicking the drop zone or selecting a file, then click Upload file.
Uploaded files appear below the upload form with:
Click an image thumbnail to open a full-size preview.
When the moderation team has finished reviewing a report, click Mark resolved in the action sidebar. The report's status changes to Resolved, the resolver and timestamp are recorded, and the report remains on the list for reference. If the DM reporting user toggle is enabled (Premium), the reporter receives a DM letting them know their report was resolved.
If a resolved report needs further attention, click Reopen report in the action sidebar. The status changes back to Open, the reopen time and reopen count are recorded, and the report returns to the active queue. If DM reporting user is enabled, the reporter is notified. Reports can be reopened multiple times — the reopen count tracks how many times.
Two optional DM notifications enhance the report workflow for Mokito Premium servers:
On a free server, both toggles are locked. Your preferences are saved and will activate when you upgrade. See the Settings → Report DM notifications section for the toggle reference.