Auto moderation

Auto moderation checks each new message in your server. When a message breaks a check you turned on, the bot removes it and can warn, time out, kick or ban the sender.

Auto moderation needs Premium. Discord's own AutoMod rules, on the Discord AutoMod tab, stay free.

Free servers that had checks on before auto moderation became premium keep those checks free. They show Kept free. Turning one off gives it up, and so does upgrading: once a server has had Premium, a later lapse keeps nothing free.

If a plan ends, auto moderation turns off, but every check keeps its settings. Turn it back on after upgrading and everything is as you left it.

Everything is off until you turn it on, so nothing changes in your server by surprise.

No code is needed. Open Auto Moderation on the dashboard. The page has three tabs:

Turn it on#

1. Open Auto Moderation → Checks.
2. Turn on the main switch at the top. The title changes from Protection is paused to show how many checks are on.
3. Turn on the checks you want.

The page saves on its own. Look for Saved under the switch.

The checks#

Each check has its own switch. Click a check to open its settings.

Links#

Written-out links count too. discord[.]gift, discord (dot) gift, discord . gift and hxxp:// are read as normal links by the link checks.

Short links are followed automatically. When any link check is on, the bot opens bit.ly and similar short links and checks where they really go: Scam links, lookalike sites, Blocked sites (adult, gambling, IP grabbers, your own list) and server invites. If a link cannot be followed, the message is not removed.

Scam links has one more switch in its settings: Catch lookalike sites. It catches new sites that copy Discord, Steam and others, before any list has them.

Spam#

Match (on Repeated messages, Same message in many channels and Spam rings) sets how alike messages must be:

• Same message: identical once numbers, emoji, spacing and mentions are ignored. buy now 1 and buy now 2 count as the same.
• Almost the same (about 90%): catches small changes, like one extra word.
• Similar (about 75%): catches bigger changes. Use it in busy servers with care, since short normal messages can look alike.

Joins#

Raids catches a wave of new members: a number of Joins within a few seconds. Pick what happens:

• Only alert the mod log
• Kick the new members
• Ban the new members

Turn on Lockdown in the Raids settings to also protect your channels during a raid. Pick the Channels, then under Do this pick Turn on slowmode or Stop everyone sending messages. The bot puts the channels back after Undo after minutes.

New accounts checks each member who joins. If the account is younger than the days you set, the bot can Only alert the mod log, Give them a role (for example a quarantine role, picked under Role to give), Kick them or Ban them.

What happens on a hit#

Each message check has its own action:

The warning never shows the link that was removed, so nobody can click it.

A ban also deletes the member's recent messages, so a spam burst in other channels goes too. Pick how much under Delete their messages from, next to Then: from none up to 7 days. The default is the previous hour.

Strikes#

Each hit counts as a strike for 30 days. Under Strikes, you can go harder on members who keep breaking the rules.

Click Add step to add a rung to the ladder. For example:

Wherever you pick a ban, on a check or on a step, you also choose how much of the member's recent messages to delete, from none up to 7 days. The default is the previous hour.

The bot always takes the harsher of the two: the check's own action, or the step the member has reached.

Strikes for one check#

Each message check also has Strikes for this check. Click the settings button (the slider icon) on the check's row to find it. Leave it empty and the check uses the server-wide strikes above. A check set to Delete and ban has none, since a ban is already the harshest step.

Add steps there and that check gets its own ladder:

• Only that check's hits count toward it. For example, 2 scam links in 30 days can mean a ban, while caps messages still follow the server-wide ladder.
• The server-wide steps are ignored for that check.
• The row shows Own strikes, so you can see which checks have their own ladder.

Exceptions#

Staff are skipped by default, like in Discord's own AutoMod. The bot leaves alone the server owner and members whose roles give Administrator, Manage Server or Manage Messages. To test the checks on yourself, turn on Check staff too on the Settings tab.

For the whole server, use Log and exceptions on the Settings tab:

• Leave these roles alone: for example your moderator role.
• Skip these channels: for example a links channel.
• Always allow these sites: sites that a link check gets wrong. Scam links, Blocked sites and Invites and links never remove them.

For one check only, click the settings button (the slider icon) on that check's row. It opens the check's settings, with the same three lists and the check's own strikes. A number on the button shows how many exceptions the check has.

Mod log#

Pick a Mod log channel under Log and exceptions. The bot posts an entry there for each action, with the member, the check and what it did. The colour of the entry shows how harsh the action was.

You can also read the last 30 days on the Log tab.

Discord AutoMod#

The Discord AutoMod tab manages Discord's own AutoMod rules. Discord runs these before a message is posted, so the message never appears.

Click New rule, then pick a Trigger:

Then pick the Actions: Block the message, Send an alert to a channel, and Timeout the member.

Permissions the bot needs#

Discord does not let a bot act on the server owner, or on members with a role higher than the bot's role. Move the bot's role up under Server Settings → Roles if an action fails.

Learn more#

• Moderation commands adds /kick, /ban and /timeout for your moderators.
• Permissions and cooldowns explains who can run what.