How to Set Up Reddit AutoModerator for Community Health

Start here: How to Create a Subreddit for Your Business: Find the Gap
TL;DR
- Reddit's AutoModerator is a free, built-in tool that removes or flags posts automatically based on rules a moderator writes, which cuts down on manual review work.
- The tool works by matching conditions (keywords, account age, karma, link domains) to actions (remove, report, flag, comment) using a YAML configuration file.
- Setting it up correctly requires access to the subreddit's mod tools and a basic understanding of YAML formatting, since small syntax errors can break the whole config.
- Moderators should start with a few simple rules and test them before adding more complex conditions, to avoid accidentally blocking normal posts.
- A well-configured AutoModerator protects genuine discussion from spam without replacing human moderation, which matters for any community trying to stay useful to its members.

Reddit moderators who manage an active subreddit often find themselves repeating the same actions: removing spam, flagging new accounts, or catching posts that break a rule. AutoModerator handles these repetitive tasks automatically, based on rules the moderator sets up in advance. It runs in the background of a subreddit and checks every post or comment against those rules, taking action right away.
This guide walks through what AutoModerator does, how its rule system works, and the steps needed to get it running in a subreddit. It also covers common mistakes that cause a config to fail, and how to test changes safely before they go live. The goal is a working setup that saves moderator time without removing content that should stay up, which keeps a community running the way it's supposed to: a space where members trust that the rules are fair and consistent.
Want the 3-part comment that gets your brand found on Reddit and Google? Get the free Reddit SEO Blueprint
Create Your First AutoModerator Rules
Moderators write AutoModerator rules in YAML format to catch spam, flag new accounts, and sort posts before a human ever sees them. Before writing any rule, a moderator needs the right permissions and access to the correct configuration page.
Check Permissions and Open the Configuration Page
A moderator needs the "manage settings" permission to edit AutoModerator. Without it, the configuration page won't appear in Mod Tools.
Steps to find the configuration page:
- Go to the subreddit and open Mod Tools.
- Check moderator permissions under User Management if Automod doesn't appear.
- Click Automod from the Mod Tools menu.
- Select Edit, or Create Page if no rules exist yet.
- The result is an open text box where YAML rules can be written and saved.
This process matches the steps described in current Reddit mod help documentation and in a recent moderator support thread covering the same setup path.
Write YAML Rules for Spam Domains and New Accounts
Two of the most common first rules target spam links and brand-new accounts. Each rule uses simple YAML structure with a check and an action.
Example: block a spam domain
domain: spam-example.com
action: remove
Example: flag new accounts
author:
account_age: "< 3 days"
action: filter
| Rule Type | What It Checks | Typical Action |
|---|---|---|
| Domain block | Link destination | Remove |
| Account age | How old the poster's account is | Filter |
| Karma check | Comment or post karma | Filter |
| Keyword match | Words in title or body | Remove or report |
Moderators can combine checks in one rule to narrow what gets caught, as explained in the full automoderator documentation.
Choose Between Filtering and Removal
Filtering and removal do different jobs, and picking the wrong one causes real problems.
Filtering:
- Hides the post from public view
- Keeps it in the mod queue for review
- Works well for new accounts or borderline cases
Removal:
- Deletes the post immediately
- No review step
- Works well for clear spam domains or banned keywords
A moderator should filter anything that might be a false positive, like a new user asking a real question. Removal fits only patterns that are reliably spam, like known spam domains or exact keyword matches tied to scams.
Getting this balance right protects real discussion while still stopping junk content from piling up, which matters for any moderator trying to keep their corner of Reddit useful to the people who actually read it.
Test and Refine Your Rules

A rule that works on paper can still cause problems once it runs on live posts. Checking each rule before and after launch catches mistakes early, before they frustrate real users.
Want the 3-part comment that gets your brand found on Reddit and Google? Get the free Reddit SEO Blueprint
Test With a Non-Moderator Account and Check the Mod Log
A second account, one without moderator permissions, shows exactly what a regular visitor experiences.
| Test Step | What to Check | Where to Look |
|---|---|---|
| Submit a post that should trigger a rule | Removal or flagging happens as expected | Mod log |
| Submit a post that should NOT trigger a rule | Post stays up, no action taken | Mod log |
| Check the removal message | Message is clear and tells the user why | Removed post |
| Review timing | Action happens within seconds | Mod log timestamp |
The mod log records every action AutoModerator takes, including which rule fired and why. Moderators should review it after each new rule goes live, not just once a week.
Weak approach: Writing a rule, saving it, and assuming it works. Strong approach: Writing a rule, testing it with a second account, then confirming the result in the mod log before trusting it with real traffic.
Review the Mod Queue for False Positives
False positives happen when a rule removes or flags a post that did not break any guidelines.
The mod queue holds every post AutoModerator flags for human review. Checking it regularly shows whether a rule is too broad.
Signs a rule is producing false positives:
- Legitimate posts from regular members landing in the queue repeatedly
- Common words in a keyword filter matching unrelated content (for example, a rule meant to catch spam links also catching normal product mentions)
- Complaints from members saying their post disappeared with no clear reason
- Patterns where one topic or phrase keeps getting caught even though it is allowed
When a moderator spots one of these signs, the fix is to narrow the rule. Adding exceptions, requiring multiple conditions to match at once, or switching from a broad keyword to an exact phrase all reduce false positives without disabling the rule entirely.
Coordinate Rules With the Spam Filter and Back Up Changes
AutoModerator and Reddit's built-in spam filter both act on posts, sometimes on the same post. Moderators should check for overlap before assuming a rule failed.
| Situation | Likely Cause | Action |
|---|---|---|
| Post removed with no AutoModerator log entry | Spam filter caught it first | Check spam filter settings, not the AutoModerator configuration |
| Post flagged twice | Both systems targeted the same content | Adjust one rule to avoid duplicate action |
| New account posts disappearing | Spam filter's account-age threshold | Confirm this is intended, not a configuration error |
Every change to the automoderator configuration should be saved as a new version in the subreddit's wiki history. Reddit's wiki keeps past revisions, so moderators can revert to an earlier version if a new rule causes unexpected removals, as detailed in the full AutoModerator documentation.
Testing and refining rules is part of leading a corner well. A community runs smoother when moderators catch problems quickly instead of letting false removals push members away.
Frequently asked questions
What permissions do I need to configure AutoModerator in a subreddit?
A moderator needs two specific permissions: "manage settings" and "manage wiki pages." Without both, the configuration page will not open for editing.
| Permission | What it unlocks | How to check it |
|---|---|---|
| Manage settings | Access to subreddit-wide configuration tools | View the moderator list in subreddit settings |
| Manage wiki pages | Ability to edit the AutoModerator wiki page directly | Look for "wiki" listed next to the moderator's name |
Full moderators usually have both by default. Mods with limited permissions may need to ask the subreddit owner to grant them, according to Reddit's own documentation.
Where can I find the AutoModerator configuration page on desktop Reddit?
The configuration page lives in the subreddit's wiki, under a page named "automoderator." A moderator can reach it in a few steps.
- Go to the subreddit and open the mod tools menu.
- Click "Wiki Pages" from the settings list.
- Select the page titled "automoderator" (or create it if it does not exist yet).
- Click "Edit" in the top corner of the page.
- The moderator now has the raw YAML editor open and ready for rule changes.
This page only appears to users with wiki edit permissions, which ties back to the permission requirements above.
How do I add rules to my subreddit's AutoModerator configuration?
Rules get typed directly into the wiki page as blocks of YAML text, then saved. Each rule is a separate block with its own checks and actions.
- Check: A condition AutoModerator looks for, like a keyword in the title or a low account age.
- Action: What happens when the check matches, such as removing the post or sending it to the mod queue.
- Comment: An optional note explaining the rule for future moderators.
A basic rule looks like this:
type: submission
title (includes): "buy now"
action: remove
After pasting a rule into the editor, the moderator clicks "Save" at the bottom of the page. The system applies the rule to new posts and comments going forward, not retroactively.
What syntax should I use when writing AutoModerator rules?
AutoModerator rules use YAML, a plain-text format that relies on indentation and colons instead of brackets or tags. Getting the structure right matters more than memorizing every option.
| Syntax element | Purpose | Example |
|---|---|---|
type: |
Tells AutoModerator what kind of content to check | type: comment |
(includes): |
Matches a word or phrase | body (includes): "spam link" |
action: |
Defines what happens on a match | action: remove |
~ (tilde) |
Makes a check a "soft" condition for scoring | ~author_flair_text: "New" |
Regex (regular expressions) can replace simple includes checks for more precise matching, though it adds complexity. A full syntax reference covers every available check and action in detail.
How can I test AutoModerator rules before using them in my community?
The safest way to test a rule is to set its action to "report" or "filter" instead of "remove" at first. This lets the moderator see what the rule catches without permanently deleting anything.
Weak approach: Write a new rule, set it to action: remove, and save it live on an active subreddit.
Strong approach: Write the rule with action: filter, save it, then submit a few test posts that should and should not match. Check the mod queue to confirm the rule behaved as expected before switching to remove.
Moderators can also use a private test subreddit to try out new rules without any risk to the main community.
Why aren't my AutoModerator rules working after I save them?
Most failed rules come down to one of a few common mistakes. Checking each one in order usually finds the problem quickly.
| Likely cause | How to check it | Fix |
|---|---|---|
| YAML indentation error | Look for mismatched spaces or tabs in the editor | Re-indent using consistent spacing (two spaces per level) |
| Rule placed below a conflicting rule | Review rule order in the wiki page | Move the rule earlier or adjust priority |
| Typo in a check name | Compare the check against the documentation | Correct the spelling exactly |
| Wrong content type specified | Confirm type: matches submission or comment |
Update the type: field |
AutoModerator applies rules in the order they appear, so an earlier rule can sometimes override or conflict with a later one. Testing each rule separately, as described above, makes these conflicts easier to spot.


