Docs

Configure AutoMod

Setup automated moderation

Automated Moderation

Danger

AutoMod automatically detects and handles rule violations including spam, profanity, invite links, and more. Configure it to match your server's needs.

Step 1: Enable AutoMod

01

Go to your dashboard and select your server

Go to your dashboard and select your server

02

Open Trust & Safety → Auto Mod

Open Trust & Safety → Auto Mod

03

Toggle "Enable AutoMod" to ON

Toggle "Enable AutoMod" to ON

04

Click "Save Changes"

Click "Save Changes"

Step 2: Configure Detection Rules

💬

Spam Detection

Prevent users from flooding channels with messages

Message Limit:Max messages in a timeframe
Duplicate Messages:Detect and remove repeated identical messages
Mention Spam:Limit @mentions per message (e.g., max 5 mentions)
Default Action:Warn → Timeout → Kick (configurable)
🔗

Link & Invite Protection

Control what links can be posted

Discord Invites:Block all Discord server invites
External Links:Block or whitelist specific domains
Shortened URLs:Block shortener domains by adding them to the blocklist
Default Action:Delete message and warn user
🤬

Profanity Filter

Filter inappropriate language

Severity Level:Word and phrase based filtering
Custom Blacklist:Add your own banned words/phrases
Bypass Attempts:Detect l33t speak and unicode variants
Default Action:Delete and warn, or timeout for repeat offenses
😱

Caps Lock Detection

Prevent excessive ALL CAPS messages

Caps Percentage:Trigger when a message is mostly caps
Minimum Length:Skip very short messages
Default Action:Warning message
📸

Image Spam

Control image and attachment flooding

Image Limit:Max images in timeframe
File Types:Restrict certain file types
Default Action:Delete extra images and warn

Step 3: Configure Actions

Decide what happens when AutoMod detects a violation:

Delete Message

Low

Automatically remove the offending message

Best for:
  • Spam
  • Links
  • Profanity

Warn User

Medium

Issue an official warning (tracked in cases)

Best for:
  • First offense
  • Minor violations

Timeout (Mute)

Medium

Temporarily prevent user from sending messages

Best for:
  • Repeated spam
  • Multiple violations

Kick

High

Remove user from server (can rejoin)

Best for:
  • Serious violations
  • Repeated offenses

Ban

Severe

Permanently remove and prevent rejoining

Best for:
  • Severe rule breaking
  • Raid attempts

Custom Message

Info

Send a DM or channel message explaining the violation

Best for:
  • Educational purposes
  • Rule reminders

Step 4: Set Up Escalation

Create an escalation path for repeat offenders:

1st Violation
Delete message + Warning
User receives a gentle reminder about the rules
2nd Violation (within 24h)
Delete message + 10 minute timeout
User is temporarily muted to cool down
3rd Violation (within 7 days)
Delete message + 1 hour timeout
Longer timeout for persistent rule breaking
4th Violation (within 30 days)
Kick from server
User is removed but can rejoin if they behave
5th Violation
Permanent ban
User has shown they won't follow rules

Tip

Adjust these escalation levels based on your server's culture. Stricter servers might escalate faster, while casual servers can be more lenient.

Step 5: Configure Exemptions

Some users or channels should bypass AutoMod:

Bypass Roles

Users with these roles won't trigger AutoMod

Examples:
ModeratorsStaffTrusted MembersVIP
Tip: Always exempt your staff roles

Exempt Channels

AutoMod won't run in these channels

Examples:
#staff-chat#bot-commands#media-sharing
Tip: Exempt channels where links/images are expected

Whitelist

Allow specific content that would normally be blocked

Examples:
Official partner server invitesYour website domainTrusted link shorteners
Tip: Be careful - only whitelist truly trusted sources

Step 6: Set Up Logging

Track all AutoMod actions for review:

01

In the dashboard, go to Server tools → Logging

In the dashboard, go to Server tools → Logging

02

Select or create a #modlog channel

Select or create a #modlog channel

03

Enable "AutoMod Actions" in logging events

Enable "AutoMod Actions" in logging events

04

Review logs regularly to fine-tune your AutoMod settings

Review logs regularly to fine-tune your AutoMod settings

What Gets Logged:

  • User who triggered AutoMod
  • What rule was violated
  • The offending message content (if applicable)
  • Action taken (delete, warn, timeout, etc.)
  • Timestamp and channel

Best Practices

Announce AutoMod rules in #rules or #welcome so members know what to expect

Announce AutoMod rules in #rules or #welcome so members know what to expect

Start with lenient settings and gradually make them stricter based on your server's needs

Start with lenient settings and gradually make them stricter based on your server's needs

Review AutoMod logs weekly to catch false positives and adjust filters

Review AutoMod logs weekly to catch false positives and adjust filters

Always exempt staff roles - they need to be able to post links and images freely

Always exempt staff roles - they need to be able to post links and images freely

Balance automation with human moderation - don't rely 100% on AutoMod

Balance automation with human moderation - don't rely 100% on AutoMod

Consider sending educational DMs to first-time offenders instead of instant punishment

Consider sending educational DMs to first-time offenders instead of instant punishment

Troubleshooting

Troubleshooting

AutoMod not triggering

  • Verify AutoMod is enabled in dashboard
  • Check if the user has a bypass role
  • Verify bot has 'Manage Messages' permission
  • Check if the channel is in exempt channels list

Too many false positives

  • Lower sensitivity levels
  • Add legitimate links to whitelist
  • Adjust spam detection thresholds
  • Review and adjust blacklisted words

Users complaining about overly strict rules

  • Review your caps lock and spam thresholds
  • Consider exempting certain channels
  • Send warning messages before taking action
  • Make rules more lenient and rely on manual moderation

🛡️ AutoMod Configured!

Your server is now protected by automated moderation. Remember to review logs regularly and adjust settings as your community grows!

Was this page helpful?