Skip to main content

๐Ÿ›ก๏ธ AutoMod (Discord native)

AutoMod rules are Discord's built-in content moderation โ€” configured from the Fren One webapp, but enforced by Discord itself, even when the agent is offline. That makes them the ideal always-on baseline underneath your Fren One filters.

Overviewโ€‹

  • Five trigger types: blocked keywords, preset word lists, spam content, mention spam, and member profile names
  • Rules run inside Discord โ€” no agent uptime required for enforcement
  • Actions per rule: block the message (with a custom notice), block the member from interacting, alert a channel, or time the member out
  • Per-rule role and channel exemptions
Discord's rule limits

Discord caps AutoMod at 6 keyword rules, and one each of the spam, preset word list, mention spam, and member profile rules per server.

Configurationโ€‹

To manage AutoMod rules:

  1. Open your project in the Fren One webapp.
  2. Select the Discord server you want to configure.
  3. In the sidebar under Agent Configuration, select Moderation, then the AutoMod (Discord native) tab.

The card lists your rules โ€” each row shows an enable toggle (applies immediately), the trigger type, and the number of actions, with edit and delete controls. Select "New Rule" to create one. Deleting a rule asks for confirmation.

Rule basicsโ€‹

OptionDescription
EnabledTurn the rule off without deleting it.
NameA label for the rule, e.g. "Block invites". Required, max 100 characters.
TriggerWhat the rule detects โ€” see below. Locked after creation: Discord doesn't allow changing a rule's trigger type, so recreate the rule to change it.

Trigger typesโ€‹

TriggerDetectsFields
Blocked keywordsCustom words/phrases and regex patterns in messages.Keywords โ€” up to 1000, 60 characters each; use * as a wildcard (e.g. spam*). Regex patterns โ€” up to 10, 260 characters each. At least one keyword or regex is required. Allowed words โ€” up to 100 exceptions.
Preset word listsDiscord's built-in lists.Word lists checkboxes: Profanity, Sexual content, Slurs. Allowed words โ€” up to 1000 exceptions.
Spam contentDiscord's automatic spam detection.No configuration.
Mention spamMessages with too many mentions.Max mentions per message โ€” 1โ€“50, default 5. Enable mention raid protection checkbox.
Member profile namesWords in usernames, display names, and nicknames.Same keyword, regex, and allowed-words fields as blocked keywords.

Actionsโ€‹

At least one action is required. Which actions are available depends on the trigger type:

ActionAvailable forDescription
Block the messageMessage-based triggersDiscord blocks the message from posting. Reveals "Message shown to the member (optional)" โ€” a custom notice, max 150 characters.
Block the member from interactingMember profile names onlyThe member can't send messages, react, or join voice until their profile no longer matches.
Send an alert to a channelAll triggersReveals an Alert channel picker (required).
Timeout the memberBlocked keywords and mention spamReveals Timeout (seconds) โ€” 1 second up to 28 days (2419200 seconds); default 600.

Exemptionsโ€‹

OptionDescription
Exempt rolesUp to 20 roles that bypass the rule.
Exempt channelsUp to 50 channels where the rule doesn't run.

How it works in Discordโ€‹

Once a rule is saved, Discord enforces it natively: matching messages are blocked before they post (with your custom notice shown to the member), alerts land in the alert channel, and timeouts are applied by Discord โ€” all without the agent being involved. This is what makes AutoMod resilient: even if the agent is offline or removed, these rules keep running.

Saving your changesโ€‹

Changes apply immediately when you save each rule โ€” there is no page-level Save bar. The enable toggle on each list row also applies instantly, and deleting a rule asks for confirmation.

Best practicesโ€‹

Layering AutoMod with Fren One filters
  • Use AutoMod for the non-negotiables (slurs, invite spam) so they're enforced even during agent downtime; use Fren One filters for anything needing warn/kick/ban escalation or new-member targeting.
  • Budget your 6 keyword rules โ€” combine related keywords into one rule instead of one rule per word.
  • Add an alert channel action to every rule so admins can spot false positives early.
  • Set a custom blocked-message notice pointing members to your rules channel.
Troubleshooting

You can't change a rule's trigger type?

  • That's a Discord restriction โ€” the trigger type is locked after creation. Delete the rule and recreate it with the new trigger.

You can't add another rule?

  • Check Discord's limits: max 6 keyword rules and one each of the spam, preset, mention, and member-profile rules.

A phrase keeps slipping through a keyword rule?

  • Keywords match literally โ€” use * wildcards (e.g. spam*) or a regex pattern for variations, and check the rule's Allowed words and exemptions.