Overview
DASHBOARD GUIDE

Moderation

The Moderation dashboard is your day-to-day enforcement console: see what your team has done, run quick actions on a member, tune AutoMod, and keep an audit trail of every change.

Path
DashboardModeration
Module
moderation
Required permission
moderation.view

Before you start

A few things make this page easier to use. None of them are strictly required to view it, but they unlock the most common actions.

  • The Moderation module is enabled for your server.
  • You have the moderation.view capability (the dashboard tab is hidden otherwise).
  • SYNTHET has the Discord permissions it needs: Ban Members, Kick Members, Moderate Members, Manage Messages.
  • You know which channel should receive AutoMod logs (you will pick it on this page).

What you'll see

The page is organised into two top-level tabs, plus three deep-link sub-pages reachable from the Quick moderation grid.

Overview
Audit
Overview
Stats strip, recent moderation actions, the Quick moderation grid, and the full AutoMod configuration.
Audit
A paginated, filter-friendly log of every moderation event the server has produced.

Linked sub-pages

  • Dashboard / Moderation / Jail & Mute — pick the roles SYNTHET assigns when someone is jailed, text-muted, image-muted, or reaction-muted, and the channel jailed users land in.
  • Dashboard / Moderation / Moderator notes — searchable staff-only notes, flags, investigations and handovers attached to specific members.
  • Dashboard / Moderation / Audit — the same audit log as the Audit tab, on its own surface for deep-linking.

Overview tab

Everything operators reach for in a normal shift lives here, top to bottom.

Stats strip

Four counters across the top of the page: Actions today, Active bans, Active timeouts and Warnings. They refresh whenever you reload the page or run a moderation action from the dashboard.

Recent actions

A live table of the latest moderation events. Each row shows the action type, the target member, the moderator, the reason, the incident severity, and how long ago it happened. The header has a small refresh button and an eye icon that opens the full audit modal. SYNTHET resolves user IDs to display names automatically and falls back to the former-member cache when someone has left.

Quick moderation grid

A 4 by 3 grid of square buttons that map to the most common manual actions. Each opens a focused modal so you do not have to leave the page.
  • Ban, Kick, Timeout, Warn — opens an action modal with user search, reason, optional duration, and PII detection on the reason field.
  • Purge messages — pick a channel and the number of messages to delete (1 to 100). Requires a confirmation step.
  • View logs — same as the Audit tab but in a modal you can dismiss without leaving Overview.
  • Manage bans — paginated ban list with one-click unban.
  • Moderator notes — opens the dedicated notes page.
  • Jail / mute — opens the jail and mute role setup page.
  • AutoMod rules — opens the rule reference modal (the live rule list is read-only in this build).

AutoMod configuration

The largest section on the page. The master toggle at the top turns AutoMod on or off; the rest of the card only appears when AutoMod is enabled. Changes save automatically when you blur a field or pick a new value, and a green confirmation banner shows after every save.
Enable AutoModToggle

Master switch. Turns every detector and action below on or off as a group.

Detection profileDropdown

Pick Relaxed, Default, or Hardened. Picking a profile rewrites every threshold below to that profile's values; you can still override individual fields after.

Example: Default

Detection thresholdsNumber

Per-trigger limits: channel messages over 10 s and 60 s, per-user messages over 10 s and 60 s, channel reactions over 10 s, thread bursts over 60 s, and voice churn over 10 s.

Example: CH_MSG_10S = 14

Action settingsNumber

How long each automatic mitigation lasts. Slowmode TTL and max TTL, and rate-limit TTL and max TTL.

Example: defaultTtlSec = 600

Anti-flap settingsNumber

Stops AutoMod toggling the same mitigation on and off. Min dwell, slowmode dedup window, and rate-profile dedup window — all in seconds.

Example: minDwellTightSec = 120

Exempt rolesMulti-select

Roles AutoMod ignores. Members with any of these roles will not trip thresholds or trigger automatic actions.

Exempt channelsMulti-select

Channels AutoMod ignores. Useful for staff-only chat, raid pits, or bot test channels.

Log channelChannel picker

Where SYNTHET posts AutoMod activity. If empty, mitigations still run but you will not see them in Discord.

BIE integration enabledToggle

Lets the Behavioural Insights Engine influence AutoMod. When on, BIE confidence scores gate which actions actually fire.

Min confidence (actions / recommendations / suppress below)Number

Three percentage thresholds. Actions and recommendations only run above their threshold; everything below 'suppress all' is dropped.

Example: 50% / 30% / 20%

Allow autopilot without BIEToggle

If BIE is unavailable, this controls whether AutoMod still acts on raw thresholds or pauses until BIE returns.

AutoMod rules summary

A read-only reference table of the seven built-in rules — invites, caps, links, slurs, mentions, emoji, and new-account guard — with their triggers, actions, scopes, match counts and on/off state. Editing rules through this surface is not exposed in the current build; the table is here so you know exactly what is running.

Audit tab

A flat, paginated log of every moderation change.

What's in the table

Five columns: Timestamp, Actor (who did it), Action (the canonical event name like BAN or AUTOMOD_CONFIG_UPDATED), Target, and Details (a short summary of the payload). Pagination kicks in at 50 rows.
Same data as the dedicated Audit page
The standalone /dashboard/moderation/audit page renders the same log with an action-name filter. Use it when you need to link a specific tab to teammates without exposing the rest of the Moderation dashboard.

Jail & Mute roles

Reachable from the Quick moderation grid. Defines which roles SYNTHET applies for jail, text mute, image mute, and reaction mute.

Open DashboardModerationJail & Mute.

SettingTypeDefaultDescription
Jail roleRole picker— (auto-create)Role applied when someone is jailed. Strips channel access except the jail channel.
Jail channelChannel picker— (auto-create)The single channel a jailed member can see. Leave blank to let SYNTHET create one.
Muted roleRole picker— (auto-create)Used by the text-mute action; blocks the member from sending messages everywhere.
Image-muted roleRole picker— (auto-create)Blocks image and attachment uploads.
Reaction-muted roleRole picker— (auto-create)Blocks adding reactions on every channel.
Auto-create on save
If you leave any of these blank and click Save, SYNTHET creates the role (and channel for jail) for you and writes the resulting IDs back to this page.

Moderator notes

The notes surface keeps staff-only context attached to specific members.

Open DashboardModerationModerator notes.

Layout

A stats strip at the top (Total, Active, Flags, Pinned, Deleted), followed by a search bar, a Filters button (target user, type, tag), and the note list. Each entry has Pin, Edit, and Delete actions. Use the Add note button at the top right to create new notes.
Note
Plain free-form context. Use for general observations.
Flag
Higher-priority entry. Renders in red and is filtered separately in stats.
Investigation
Open case. Pair with tags and a target so it threads across staff.
Handover
Shift-end summary you want the next moderator to read first.

Common tasks

1

Ban a member from the dashboard

Use the Quick moderation grid when you want a clean record of who pressed the button.

  • Click Ban in the Quick moderation grid.
  • Type the member's name in the user search field; pick the match from the dropdown.
  • Add a reason. The field flags emails, phone numbers, and SSNs so you can scrub PII before saving.
  • Press the destructive confirm button. The Recent actions table updates immediately.
2

Tighten AutoMod for a raid

If you're getting hit, don't fiddle with thresholds individually — pick the Hardened profile.

  • Open the AutoMod card on Overview.
  • Make sure Enable AutoMod is on.
  • Click the Hardened tile under Detection profile. SYNTHET rewrites every threshold to the hardened defaults and saves automatically.
  • When the raid is over, click Default or Relaxed to revert.
3

Wire AutoMod logs to a channel

No log channel means AutoMod runs silently. Pick one before you go to bed.

  • Open the Log channel picker inside the AutoMod card.
  • Type the name of a staff-only channel, pick it, and confirm. The save indicator confirms the write.
  • Drop a test slur or 20 messages in 10 seconds from an alt account to verify the log post lands.

Troubleshooting

Missing bot permissions banner
A yellow banner at the top of the page lists Discord permissions SYNTHET is missing in this server (typically Ban Members, Moderate Members or Manage Messages). Re-invite the bot or grant the missing permissions to the SYNTHET role and refresh — the banner clears once the API confirms.
AutoMod is on but nothing is happening
Three usual causes: every thresholded event is being filtered by an exempt role or channel; BIE integration is on with confidence floors high enough to suppress all actions; or no log channel is set so the actions are happening invisibly. Check exemptions first, then drop the BIE thresholds, then set a log channel.
Notes page says 'database setup required'
The Moderator notes tables haven't been created yet. From the web/ project directory, run npx prisma db push and refresh the page.
Action says 'forbidden' for one moderator only
That moderator does not have the moderation.act capability for the action they tried. Open RBAC, find their role and grant the specific capability (for example moderation.ban) — or move them onto a template role that already includes it.