Documents

Moderation & AutoMod

How Miko's keyword filter works, how to configure it from the dashboard or a command, and the auto-bootstrap starter filter.

How it works under the hood

Miko's AutoMod feature doesn't run its own message-scanning engine. Instead, it creates and manages a real Discord AutoMod rule for your server through Discord's own moderation API. That has a few practical consequences worth understanding before you configure anything:

  • The rule keeps working even if Miko goes offline โ€” Discord enforces it directly.
  • It shows up in your server's own Server Settings โ†’ Safety Setup โ†’ AutoMod page, where any admin with Manage Server can view, edit, or delete it directly โ€” with or without Miko.
  • It's subject to Discord's own AutoMod limits, most notably one rule of trigger type Keyword Preset per server (relevant to the starter filter, below).

Configuring it from the dashboard (recommended)

  1. 1

    Open your server

    Go to /servers, log in with Discord if prompted, and pick the server you want to configure.
  2. 2

    Go to Moderation โ†’ Automod

    It has its own section in the sidebar, separate from general Guild Settings.
  3. 3

    Turn the filter on

    Flip the toggle at the top of the panel. This is the same on/off state as /automod enable and /automod disable.
  4. 4

    Add keywords

    Type a word or phrase and press Enter or , to add it as a chip. Click the ร— on any chip to remove it. The counter shows how many of the 100 allowed keywords you've used.
  5. 5

    (Optional) Pick an alert channel

    Choose a text channel from the dropdown to get a log message every time the filter blocks something. Leave it on "No alert channel" to filter silently.
  6. 6

    Save

    Changes apply immediately to the live Discord AutoMod rule โ€” no bot restart, no propagation delay.

Permission required

Both the dashboard panel and the slash command require the Manage Server Discord permission. Members without it will see a locked message instead of the controls.

Configuring it with the slash command

Everything the dashboard panel does maps directly onto /automod โ€” they operate on the exact same rule, so a change made in one place is immediately reflected in the other.

  • /automod enable keywords:<comma,separated,list>Create the rule if it doesnโ€™t exist yet, or update its keyword list if it does
  • /automod enable keywords:... alert_channel:#channelSame as above, plus route block alerts to a channel
  • /automod enable keywords:... rule_name:"My Rule"Optional โ€” give the rule a custom name instead of the default
  • /automod statusShow whether the rule is enabled and how many keywords it has
  • /automod disableTurn the rule off without losing your keyword list (re-enable later to restore it)

Limits

  • Up to 100 keywords or phrases per rule.
  • Each keyword/phrase can be at most 60 characters.
  • Duplicate keywords are automatically de-duplicated.

Keywords beyond the limit are dropped silently

If you submit more than 100 keywords, or any single entry longer than 60 characters, the excess entries are simply not included โ€” there's no error, just a smaller saved list than you typed. Check /automod status or the dashboard's keyword counter after saving to confirm everything you intended was kept.

The starter filter (auto-bootstrap)

Eligible servers automatically get a second, separate rule created the first time Miko notices the server already uses Discord AutoMod in some form. This starter filter blocks Discord's built-in Profanity, Sexual Content, and Slurs presets โ€” it's meant as a sensible default, not a replacement for your own keyword rule above.

Eligibility rules

  • Miko must have the Manage Server permission in that server.
  • The server must already have at least one AutoMod rule configured (Miko won't introduce AutoMod to a server that has never used it).
  • Discord caps rules of trigger type Keyword Preset at one per server. If your server's own AutoMod setup already uses one, Miko skips creating the starter filter and marks the server as ineligible rather than retrying every restart.

Because it's a normal Discord AutoMod rule, the starter filter is fully visible and editable from Server Settings โ†’ Safety Setup โ†’ AutoMod โ€” and the dashboard's Automod panel shows its current status as a read-only card so you know it exists and what it blocks, without duplicating controls for it.

Mod logs

Separate from the keyword filter, /modlogs setup lets you choose a channel for general moderation event logging, and /modlogs toggle turns specific event types on or off for that channel.

FAQ

I enabled the filter but messages still aren't being blocked

Double check the keyword actually matches โ€” Discord AutoMod keyword rules match whole words/phrases, not substrings, by default. Also confirm the rule shows as Enabled in /automod status or the dashboard; a disabled rule keeps its keyword list but doesn't enforce anything.

Can I have more than one keyword rule?

Through Miko's command and dashboard, you manage one keyword rule (plus the separate starter preset rule, if eligible). For more advanced multi-rule setups, use Discord's own Safety Setup page directly โ€” Miko won't touch rules it didn't create.

Why does the dashboard show a rule I never created?

That's almost certainly the starter filter described above โ€” it's created automatically for eligible servers, shown read-only in the dashboard, and manageable directly in Discord's own settings.

Does disabling the bot remove the AutoMod rule?

No โ€” since it's a native Discord AutoMod rule, removing Miko from your server does not delete it. You'd need to remove it from Server Settings โ†’ Safety Setup โ†’ AutoMod directly.