Iris
Add to Discord

AutoMod

Automated moderation rules and filters.

Configure AutoMod in the dashboard

Overview#

AutoMod checks every message against the filters you turn on and acts the moment one matches. Spam, mass mentions, emoji floods, shouting, banned words, links and attachments each have their own filter, their own thresholds and their own action.

Repeat offenders escalate. Turn escalation on and a member who keeps tripping filters inside the tracking period moves up your ladder on their own, from a warning to a mute to a ban, without staff having to notice the pattern.

Administrators and anyone with Manage Messages always bypass AutoMod, and you can exempt further roles and channels on top of that.

Setup#

  1. Open the dashboard and go to Moderation > AutoMod, then turn the module on.
  2. Apply a preset under Quick Setup: relaxed, balanced or strict. It fills the filters in for you.
  3. Set the Log Channel so you can see what it is catching.
  4. Add your staff roles under Bypass so they are never checked by their own rules.
  5. Open the filters you care about and adjust the thresholds, then save.
  6. Read the log for a day, then tighten or relax from real matches rather than guesses.

Filters#

Every filter is off until you turn it on, and every one ends in an action: warn, delete the message, mute as a Discord timeout, kick or ban.

FilterCatchesDefault action
Anti-Spam5 messages from one member within 5 secondsMute for 300 seconds
Mention LimitsMore than 5 mentions in one messageMute for 300 seconds
Emoji LimitsMore than 10 emojis in one messageWarn
Caps Limits70% capitals in a message of 10 characters or moreWarn
Word FilterYour word lists, split into mild, severe and extremeDelete, mute, ban
Link FilterLinks, with a whitelist and a blocklistDelete
Attachment FilterMore than 5 attachments, or files over 25 MBDelete

Settings#

SettingTypeDefaultWhat it does
Enable AutomodToggleOffThe master switch. No filter runs while it is off.
Log ChannelChannelNoneWhere every AutoMod action is posted.
Bypass rolesRolesNoneMembers holding any of these are never checked.
Bypass channelsChannelsNoneMessages here are never checked.
Message limitNumber5Anti-spam. Messages from one member inside the window before it fires.
Time window (seconds)Number5Anti-spam. How long that count is measured over.
Mute duration (seconds)Number300How long a mute lasts, on any filter whose action is mute.
Max mentions per messageNumber5Mention limits. Counts members and roles together.
Max emojis per messageNumber10Emoji limits. Standard and custom emojis both count.
Caps threshold (%)Number70Proportion of capitals that counts as shouting.
Minimum message lengthNumber10Caps limits ignore messages shorter than this.
ActionChoiceVariesPer filter: warn, delete message, mute, kick or ban.
Word listsListEmptyMild, severe and extreme, each with its own action and duration.
Max attachments per messageNumber5Attachment filter. Above this the message is caught.
Max file size (MB)Number25Attachment filter. Larger uploads are caught.
Staff role to pingRoleNonePinged when a filter fires, if staff notifications are on.
Repeat-Offender EscalationToggleOffMove a member up the ladder as violations add up.
Tracking period (seconds, 86400 = 24h)Number86400How long violations are counted for before they age out.
ViolationsNumber-Per escalation step: the count that triggers this step, and the action it takes.

Commands#

CommandWhat it doesRequires
.automod helpWord filters, spam, caps, mentions and bypasses from chat.Manage Server

Permissions#

PermissionWhy Iris needs it
Manage MessagesDeletes the message that broke a rule.
Moderate MembersApplies the timeout when a filter escalates to a mute.
Kick MembersOnly for filters whose action is kick.
Ban MembersOnly for filters whose action is ban.
View ChannelsReads the channels it filters, and the log channel.
Send MessagesWrites the log entry and the warning.

What it looks like#

I
Iris APP Today at 8:52 PM

AutoMod action taken.

Member

@member

Filter

Anti-spam

Action

Muted for 300s

Detail

7 messages in 5 seconds in #general

A spam catch in the AutoMod log channel.

Tips and gotchas#

A filter is catching normal conversation.

Raise the threshold or the minimum length rather than turning the filter off. Caps and emoji limits are the usual pair.

Staff keep getting caught.

Add their role under Bypass. Administrators and members with Manage Messages already bypass every filter.

Why is there a separate anti-link module?

The link filter here handles the common cases. Anti-link adds invite blocking, NSFW blocking, per-channel exemptions and its own enforcement log.

Do escalation steps reset?

Yes. Violations age out after the tracking period, 86400 seconds by default.