> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hedwig.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Automod

> Set up message filtering and manage carefully reviewed exceptions.

Automod handles message-level protection such as spam, unwanted links, bad
words, NSFW content, caps abuse, mass mentions, emoji and attachment spam,
long messages, newline spam, and repeated cross-channel content. Configure it
gradually and pair it with logging so staff can review false positives.

## Commands

| Command              | Use it to                    |
| -------------------- | ---------------------------- |
| `/automod setup`     | Configure automod modules    |
| `/automod enable`    | Turn automod on              |
| `/automod disable`   | Pause automod                |
| `/automod reset`     | Remove automod configuration |
| `/automod whitelist` | Manage automod exceptions    |

## Available modules

The setup panel currently exposes these modules:

| Module               | What it catches                                   |
| -------------------- | ------------------------------------------------- |
| Anti Spam            | Bursts and repeated content                       |
| Anti Link            | External links, shorteners, and IP URLs           |
| Anti Invite          | Discord invite links                              |
| Anti Bad Words       | Built-in multilingual list or a custom list       |
| Anti NSFW            | NSFW text and images                              |
| Anti Caps            | Excessive capitals and combining-character abuse  |
| Anti Ping            | `@everyone` and `@here` pings                     |
| Anti Mass Mention    | Large or repeated mention bursts                  |
| Anti Emoji Spam      | Emoji-heavy messages                              |
| Anti Attachment Spam | Multiple files or rapid upload bursts             |
| Anti Char Limit      | Messages over 900 characters                      |
| Anti Newline Spam    | Messages with 8 or more line breaks               |
| Anti Scam Spread     | The same message posted across 3 or more channels |

The bad-word and NSFW modules also synchronize Discord AutoMod rules when the
bot has **Manage Server**. The built-in bad-word list is multilingual; use the
setup panel's custom-list option when the server needs its own vocabulary.

## Recommended rollout

<Steps>
  <Step title="Start in a test channel">
    Use a private staff channel or a small test server to validate the behavior.
  </Step>

  <Step title="Enable one layer at a time">
    Record which filters are active and what they should do when they match.
  </Step>

  <Step title="Review exceptions">
    Add only the channels, users, or roles that genuinely need an exception.
  </Step>

  <Step title="Monitor logs">
    Watch the logging channel for false positives after enabling automod.
  </Step>
</Steps>

<Tip>
  If a filter is too aggressive, pause automod with `/automod disable`, adjust the configuration, and test again instead of adding broad allowlist entries.
</Tip>