How to Reddit AutoModerator Bot: Build Your First Rule Set Without Breaking the Sub

You want to configure the Reddit AutoModerator bot so it removes spam, filters low-quality posts, and sends a helpful comment when someone breaks a rule. You don’t want to become a full-time YAML developer, and you definitely don’t want to accidentally nuke your entire subreddit on day one.

Good news: the basics are simple. Bad news: the docs are scattered, and one bad indent can break everything silently. This guide walks you through the setup the way we actually do it.

Before you start: what you need

• Mod permissions on the subreddit (at least config and posts).
• A subreddit that isn’t already heavily customized (if it is, read the existing config first — don’t overwrite it).
• A test subreddit (like r/yourname_test) so you don’t break your main community.
• Basic understanding of YAML: indentation with two spaces, no tabs, and --- at the top of the file.

AutoModerator can remove posts, remove comments, filter content for mod review, reply with a message, and check for keywords, domains, karma, account age, and more. It cannot judge context, read images, or understand sarcasm. Keep that in mind before you write overly aggressive rules.

Step 1: Open the AutoModerator config page

Go to https://www.reddit.com/r/YOURSUB/wiki/automoderator.

If it doesn’t exist yet, click create. If it does exist, open it and copy the content to a backup file before touching anything.

You also need to make sure AutoModerator is invited as a moderator with the config permission. In Mod Tools → Moderators, check if AutoModerator is listed. If not, add it with config and posts permissions. Without this, your config won’t run at all.

Step 2: Learn the 3 core YAML concepts

You don’t need the full docs. You need three things:

1. Conditions — what triggers the rule (type: submission, title (includes): ["spam"], author: comment_karma, etc.).
2. Actions — what happens when the condition is true (action: remove, action: filter, action: approve).
3. Messages — what AutoModerator says (comment, message, or both).

Here’s a minimal example:

---
type: submission
title (includes): ["free crypto"]
action: remove
comment: |
 Your post was removed because it mentions crypto giveaways.
 This is against our rules. Please review them before posting again.

Note the | symbol — it lets you write multi-line comments. Indentation matters. Two spaces. No tabs.

Step 3: Write your first 3 practical rules

Start small. Three rules that actually solve problems:

Rule 1: Remove posts from accounts with very low comment karma.

---
type: submission
author:
 comment_karma: "< 5"
action: filter
message: "Your post was filtered because your account is new. One of the mods will review it soon."

Use filter instead of remove for karma rules. Filtering sends the post to the mod queue — you can approve it manually if it looks good. You avoid removing content from genuinely new users who just want to participate.

Rule 2: Block common spam domains.

---
type: both
domain (includes): ["example-spam-site.com", "another-scam.net"]
action: remove
comment: "This domain is not allowed in our subreddit."

type: both covers submissions and comments. This is the most common use case for the Reddit AutoModerator bot — if you run any kind of community, you will get domain spam.

Rule 3: Auto-reply when someone uses a certain trigger word.

---
type: comment
body (includes): ["how do I get clients"]
action: approve
comment: |
 This question gets asked a lot. Check our wiki guide on client outreach:
 https://www.reddit.com/r/YOURSUB/wiki/client-guide

This one approves the comment (so it doesn’t get caught by other filters) and adds a helpful reply. Great for FAQ-style questions.

Step 4: Test your rules safely

Never save a config directly to your main subreddit without testing. Here’s the workflow:

1. Create a test subreddit: r/yourname_test.
2. Invite AutoModerator there with the same permissions.
3. Copy your config to the test sub’s wiki.
4. Make a test post with the trigger phrase, a test comment, and a test link.
5. Check what happens. Did it remove? Did it filter? Did the comment appear?

If the rule doesn’t fire, don’t guess. Check the mod log.

Step 5: Check the mod log and refine

Go to Mod Tools → Mod Log. Filter by automoderator. You’ll see every action the bot took, including why.

Common issues:

• Rule didn’t fire — usually a YAML indentation error or a typo in the condition.
• Rule fired too much — your keyword list is too broad. includes matches substrings, so “crypto” will match “cryptocurrency” and “crypto-currency”. Use regex: "\\bcrypto\\b" for whole-word matching.
• Rule fired on the wrong type — check if you used type: submission when you meant type: both.

Common blockers and fixes

• AutoModerator isn’t responding at all — check if it’s invited as a mod with config permission. Check if the config page exists and has content.
• YAML errors — use a YAML validator online before saving. One missing space can break the whole file.
• Posts are being removed but you don’t see them in the mod queue — if you use action: remove, they go straight to spam. Use filter if you want to review first.
• The comment is too long — AutoModerator comments are limited to 1000 characters. Keep messages short.
• You broke your subreddit’s existing rules — you backed up the old config, right? Restore it from your backup file.

Practical example: building a rule set for a small freelance community

Let’s say you moderate r/freelancecafe, a sub for freelance writers and designers. Your main problems are:

• People posting “hire me for $5” spam.
• New accounts posting low-effort content.
• The same “how do I find clients” question every week.

Your config could look like this:

---
# Remove spammy hire-me posts
type: submission
title (includes): ["hire me", "cheap logo", "$5", "$10"]
action: remove
comment: "No self-promotion or gig posts. Read the rules."

---
# Filter low-karma accounts
type: submission
author:
 comment_karma: "< 10"
action: filter
message: "Your post is pending mod review. Please be patient."

---
# Auto-reply to common questions
type: comment
body (includes): ["find clients", "get clients", "first client"]
action: approve
comment: |
 Quick answer: check the wiki's client outreach guide.
 It covers cold emails, portfolios, and pricing.

Save this to your test sub first. Run it for a few days. Check the mod log. Then apply it to the real subreddit.

Checklist before you publish your config

• [ ] AutoModerator is invited with config and posts permissions.
• [ ] You backed up the existing config.
• [ ] You tested the config in a separate test subreddit.
• [ ] You used filter instead of remove for new accounts.
• [ ] You checked for regex or substring issues in keywords.
• [ ] Your comments are under 1000 characters.
• [ ] You checked the mod log 24 hours after publishing.
• [ ] You have a plan to review filtered posts daily.

A note on account quality

If you’re setting up AutoModerator because your subreddit keeps getting hit by spam from low-quality accounts, that’s exactly what the bot is for. But if you’re on the other side — you’re building a new account to participate in communities, and you keep getting filtered — the issue isn’t always your post. Sometimes it’s your account history. A Reddit account with visible comment karma and a real posting history is far less likely to trigger karma-based rules. That’s why many marketing teams and founders review whether a ready account with a genuine comment history makes sense for their workflow before they start posting — it saves the frustration of getting auto-filtered by bots like this one.

Practical takeaway

Start with three rules, test them in a separate subreddit, and check the mod log for a few days before expanding. The Reddit AutoModerator bot is powerful, but it’s not smart. It does exactly what you write — nothing more. Write less, test more, and you’ll have a working auto-mod setup within an hour.

For a broader comparison, review how to reddit automoderator bot before committing to one setup or workflow.

FAQ

Q: How do I know if AutoModerator removed my post or comment?
A: Check the mod log in the subreddit’s Mod Tools. Filter by “automoderator” to see all actions it took. If you’re not a mod, your post will just show as “removed” without a reason. You can also send a modmail to ask for clarification.

Q: Why is my AutoModerator rule not working?
A: Most common causes: AutoModerator isn’t invited with config permission, there’s a YAML indentation error in the file, or the condition is written incorrectly. Test the rule in a separate test subreddit and check the mod log to see if it fires.

Q: What is the difference between “remove” and “filter” in AutoModerator?
A: remove deletes the post or comment immediately. filter sends it to the mod queue for review — the user still sees it as “pending” but it’s not visible to the public. For new accounts or borderline cases, filter is safer because a human can approve it later.

Q: Can AutoModerator approve posts automatically?
A: Yes. Use action: approve to automatically approve content that matches certain conditions. This is useful for trusted users or known-good domains. You can also combine it with action: filter to handle edge cases.

Q: Does AutoModerator require a separate Reddit account?
A: No. AutoModerator is a built-in bot account that Reddit provides to every subreddit. You just need to invite it with the right permissions and write rules in the wiki page.