docs

Search docs

Search the Metryx documentation

Get started

Moderation

AutoMod

A free rule engine that checks every message the moment it arrives. Keywords, links, spam, scams.

How AutoMod works

Where to find it:SidebarModerationAutoMod

AutoMod is a rule engine that sits on the live message stream. Every message gets checked against your enabled rules the moment it arrives, and a match triggers whatever outcome you configured: delete, warn, timeout, or escalate.

Note

AutoMod is free on every plan, including Free. It never turns off behind a paywall.

Rule edits take effect within seconds of saving. What you see in the editor is what's enforcing.

Note

Staff are exempt. Anyone holding one of your moderation roles, a role with Administrator, or the server owner never trips an AutoMod rule. Staff role changes apply within a few minutes.

Server-wide exemptions

Where to find it:SidebarModerationAutoModServer-wide exemptions

Server-wide exemptions sit at the bottom of the AutoMod page and cover every rule at once. Anything listed there is checked before any rule runs, so you set it once instead of adding it to each rule and remembering it again on the next one.

Exempt roles are members who never trip a rule, like a bots role or a trusted-regulars role. Exempt channels are places where nothing is checked at all, like a staff channel or a spam-for-fun channel.

Note

Per-rule exempt roles still exist, in the rule editor, for one-off carve-outs. Use those when a role should skip one rule and use this when it should skip all of them.

Warning

An exempt channel is a real blind spot. Nothing posted there is filtered, including scam links, so only exempt channels you are happy to leave unwatched.

Creating a rule

  1. 1

    Open AutoMod and create a rule

    Go to Moderation → AutoMod and hit New rule. Each rule gets a full-page editor.

  2. 2

    Pick the type and fill in the details

    Choose what the rule watches for (keywords, links, spam) and set the specifics, like the word list or which links count as advertising.

  3. 3

    Choose the outcome

    Decide what happens on a match: delete the message, warn the member, time them out, or escalate. You can also have the bot DM the member so they know what happened.

  4. 4

    Test it, then enable it

    Paste a few real messages into the rule's playground and check the verdicts. When it behaves, flip it on.

Rule types

  • Keyword rules: block words and phrases, with evasion normalization (below) so creative spelling doesn't slip through.
  • Anti-advertising: server invites and self-promo links, with allowances you control.
  • Phishing & scam links: known-bad domains and scam patterns, including links pasted without the https:// to dodge URL detection.
  • Spam pressure: repeated messages and flooding.

Evasion normalization

Before matching, AutoMod normalizes the message. Lookalike unicode characters, weird spacing, and stretched-out repetition all collapse back to plain text first. So f r є є n í t r о still matches a "free nitro" rule.

You write the rule once. The engine handles the disguises.

The playground

Where to find it:ModerationAutoModany rulePlayground

Every rule editor has a playground: paste a real message and see exactly which rules match and what would happen. Nothing is enforced from the playground, so you can test as roughly as you want.

Tip

Keep the messages from your last incident around. They make the best test cases for a new rule.

Per-rule statistics

Where to find it:ModerationAutoModany ruleStats

Each rule has its own stats page: a trigger trend over time, the identities it caught, and top offenders. The flagged-messages table shows every hit with the matched excerpt.

A rule that never fires is dead weight. A rule that fires constantly is probably too broad. The stats page is how you tell.