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

# AutoMod

> Invites, links, caps, mass mentions, spam and filtered words · all off until you turn them on.

AutoMod watches messages and message edits as they arrive. Every rule is per-guild and **disabled by default**, and the bot never acts on anyone it couldn't moderate anyway.

## Enable it

```text theme={null}
/config toggle automod enabled:True
/automod filter rule:"server invites" enabled:True
/automod filter rule:"any link" enabled:True
/automod action action:"delete and warn"
```

## What it checks

| Rule | Trips when |
| - | - |
| Invites | A `discord.gg`, `discord.io`, `discord.me`, `discord.li` or `discord.com/invite` link appears |
| Links | Any `http(s)://` URL appears |
| Filtered words | A whole word from your list appears (case-insensitive, max **200** words) |
| Caps | A message of 10+ characters is at least *N*% uppercase |
| Mass mentions | User + role mentions + `@everyone` exceed the limit |
| Spam | One member sends more than *N* messages in a 5-second window in the same channel |

```text theme={null}
/config number automod-caps 70
/config number automod-mentions 5
/config number automod-spam 5
```

## What happens when a rule trips

The message is deleted first, then the configured action runs:

| Action | Behaviour |
| - | - |
| `delete` | Message removed, nothing else |
| `warn` | Message removed and a warning case written |
| `timeout` | Message removed and the member timed out for **10 minutes** |

A short-lived warning is posted in the channel and disappears after 8 seconds. The full record lands in the log channel with the user, channel, matched rule, action, result and the deleted content (truncated to 500 characters).

> [!NOTE]
>
> Once spam is actioned for a member in a channel, AutoMod stays quiet for that member/channel pair for 5 seconds so a flood produces one record instead of twenty.

## Exemptions

Members with **Manage Messages**, bots, members whose top role is at or above the bot's, exempt roles and exempt channels are always skipped.

```text theme={null}
/automod exempt role:@Staff
/automod exempt channel:#bot-spam
/automod exempt role:@Staff remove:True
```

## Managing the word list

```text theme={null}
/automod addword "banned phrase"
/automod removeword "old phrase"
/automod words
```

`/automod words` shows the list behind a spoiler. Matching is whole-word, so `ass` does not trip on `class`, and it handles punctuation at either end.

## Checking the current state

```text theme={null}
/automod status
```

Shows whether the module is on, the action, each rule's limit, how many words are filtered, and the exempt roles and channels.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.