Settings reference
Every AutoMod setting, type, default, and behavior.
| Setting | Type | Default | What it does |
|---|---|---|---|
antiSpam | boolean | false | Enables per-guild, per-user burst tracking in memory. |
antiSpamLimit | integer | 5 | Triggers when the count becomes greater than this limit inside the window. |
antiSpamWindow | seconds | 5 | Spam tracking window length. When the window expires, the count resets. |
blockLinks | boolean | false | Checks http:// and https:// URLs in message content. |
allowedDomains | JSON string array | [] | Allowed domains. example.com also allows subdomains such as www.example.com and a.example.com. |
antiCaps | boolean | false | Checks uppercase percentage after removing non-letters. Messages with fewer than 8 letters are ignored. |
capsThreshold | integer percent | 70 | Triggers when uppercase letters are at least this percentage. |
badWordsFilter | boolean | false | Enables case-insensitive substring matching against configured phrases. |
badWords | JSON string array | [] | Blocked words or phrases. The dashboard lowercases newly added entries. |
antiSpamAction | string | DELETE | Action for spam triggers. Accepted values: DELETE, WARN, TIMEOUT, KICK, BAN. |
linksAction | string | DELETE | Action for blocked-link triggers. |
capsAction | string | DELETE | Action for caps triggers. |
badWordsAction | string | DELETE | Action for bad-word triggers. |
timeoutSeconds | seconds | 300 | Shared duration for any rule whose action is TIMEOUT. Dashboard input allows 60 to 2,419,200 seconds. |
Action details
DELETE posts a temporary channel notice and removes it after 6 seconds. WARN sends a DM. TIMEOUT, KICK, and BAN attempt the Discord moderation action only if the member is moderatable, kickable, or bannable.
Malformed URLs are treated as blocked when the link filter is on. The first blocked URL is included in the moderation reason. For bad words, the reason shown to the user is generic: “Prohibited word detected”.
