AutoModerator

AutoModerator checks every new post and comment in a vault against rules its moderators write, and acts on the ones that match: removing spam, flagging posts for a moderator to look at, setting flair, replying with a note, and so on. It only does anything in vaults that have rules; a vault without them is never touched.

Where the rules go

Moderators with the "wiki" permission write the rules on the vault's wiki page config/automoderator: go to /v/yourvault/wiki/config/automoderator and edit it. Only moderators can see the page. When you save, the rules are checked, and a mistake is pointed out instead of saved. New rules apply to posts and comments made after you save; they don't go back over old ones.

Rules are written in YAML. Each rule is a list of settings, and rules are separated by a line of three dashes:

# remove links to a spam site
domain: spamsite.example
action: remove
action_reason: "spam domain"
---
# hold posts from brand-new accounts for a moderator to look at
type: submission
author:
    account_age: "< 1 day"
action: filter
action_reason: "new account"

Lines starting with # are notes for you, and AutoModerator ignores them.

Which items a rule looks at

Checks

A rule's checks must all match for it to act.

Text in the post or comment. The field name, and what to look for. Several values in a list match if any of them is there:

title: [free, giveaway, "click here"]

How the text is searched, in parentheses after the field name, e.g. title (starts-with): "[meta]":

Other checks on the post or comment:

Checks on the author, inside author::

author:
    post_karma: "< 5"
    comment_karma: "< 5"
    account_age: "< 3 days"
    satisfy_any_threshold: true

Checks on the post a comment is in, inside parent_submission:, with the submission fields above:

type: comment
parent_submission:
    flair_text: "Announcement"
action: remove

Actions

What happens when everything matches:

Replies and messages to the author end with a note that AutoModerator is a bot, with a link to message the moderators; messages to the moderators start with a link to the post or comment.

Placeholders

In comment, message, modmail, their subjects and action_reason, these are filled in:

Examples

Reply to every new post with a reminder of the rules:

type: submission
comment: |
    Thanks for posting, {{author}}! Please make sure your post follows the
    rules in the sidebar.

Report posts that collect three reports, so they're easy to find:

reports: 3
action: filter
modmail: "{{permalink}} has 3 reports and is waiting in the queue."

Mark posts with "nsfw" in the title as NSFW:

type: submission
title: [nsfw, "18+"]
set_nsfw: true

Remove comments that only say "first":

type: comment
body (full-text): ["first", "first!"]
action: remove
action_reason: "low effort"

Tips

π Rendered by PID 554642 on tippr at 2026-11-22 15:29:16.644017+00:00 running (unknown) .