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 Servercan 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
Open your server
Go to /servers, log in with Discord if prompted, and pick the server you want to configure. - 2
Go to Moderation โ Automod
It has its own section in the sidebar, separate from general Guild Settings. - 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
Add keywords
Type a word or phrase and pressEnteror,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
(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
Save
Changes apply immediately to the live Discord AutoMod rule โ no bot restart, no propagation delay.
Permission required
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
/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 Serverpermission 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
/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?
Why does the dashboard show a rule I never created?
Does disabling the bot remove the AutoMod rule?