Skip to content

Guide

Set up auto-moderation rules

Moderation & safety · 6 min read

Auto-moderation rules (auto-mod rules) check new content automatically and act on anything that matches: they block it, hold it for review, or publish it and notify your team. Use them as a word filter, to match patterns, or as a spam filter.

Who can do this: Owners and admins create, edit, and delete rules. A custom role needs Configure automated moderation rules to change them. Moderators, and roles with only View moderation queue, see the rules read-only and can try them. Space admins can add keywords that need review for their own space. · Where: Web (admin console). · Plan: Rules have no plan requirement. Require Post Approval depends on your platform plan.

Open the Automated Moderation page

Go to Admin → Moderation → Automated Moderation. This page used to be called Auto-Mod Rules.

At the top, Community-wide settings is where owners and admins turn Require Post Approval and Enable AI moderation on or off (previously on the Content Safety page), with a button to AI settings. The switches save right away. Everyone else sees whether Post approval and AI moderation are on. Below it are four tabs:

  • Rules: your keyword, regex, and spam filter rules.
  • Blocked: what Block rules refused in the last 30 days.
  • AI settings (owners and admins only) and AI decision log: see Use AI to moderate content.

Each rule shows its type, its action, the spaces and content it applies to, its priority, how many times it was triggered, and how many of those matches were blocked, held, or notified.

New communities start with one Spam Filter rule. It holds posts, blog articles, and events for review when they contain more than 5 links, or the same character repeated more than 20 times in a row. You can edit, turn off, or delete it like any other rule.

What auto-moderation rules check

Rules check:

  • posts when they're published or edited, including replies, comments, and answers in Q&A spaces;
  • blog articles when they're published or edited;
  • events when they're created or edited.

Rules don't check messages in chat spaces or direct messages. They skip content from the community owner, admins, and moderators (and custom roles with Resolve moderation items), and from the admins and moderators of the space it's posted in.

Rules still run when a space or the community requires approval for new posts. Block still refuses the content. Other matches are added as another Reason for review on the same item in Pending Content.

Choose an auto-moderation rule type

Rule Type What it matches Settings
Keyword A specific word or phrase Whole word only, Case-sensitive
Regex Pattern A regular expression (RE2 syntax) Add (?i) to the pattern for case-insensitive matching
Spam Filter Spammy content with too many links or long runs of repeated characters Max links, Max repeat run, Min length for repeat check, Count Unicode repeats

For spam thresholds, 0 means don't check it and an empty box uses the default. Rules look only at the content itself, not at who posted it, such as new members.

Choose what an auto-moderation rule does

Action What happens when content matches
Block The content isn't saved and never reaches Pending Content. The author sees a general message, such as "Your post contains content this community doesn't allow. Please edit it and try again." A blog article is held for review instead.
Hold for review The content is saved but hidden until someone approves or rejects it in Pending Content. The author is told it's waiting for review.
Publish and notify The content is published as usual, and it's listed in Pending Content so your team can check it. The author isn't told.

Members never see a rule's name. When several rules match, the most severe action wins: Block, then Hold for review, then Publish and notify. Among rules with the same action, the lower Priority number decides. Every matching rule counts as triggered.

Editing an event that's already published never takes it offline: Hold for review works like Publish and notify there.

Create an auto-moderation rule

  1. On the Rules tab, click Add Rule.
  2. Enter a Name and, if you like, a Description.
  3. Choose a Rule Type. Then enter the Keyword / Phrase or Pattern (Regex), or adjust the spam thresholds.
  4. Choose an Action: Block, Hold for review, or Publish and notify.
  5. Under Applies to, choose Posts (feed posts and their replies), Blog articles, or Events. Leave everything unchecked to cover all content.
  6. Under Scope, leave it empty to apply the rule community-wide, or pick specific spaces.
  7. Set a Priority.
  8. Optionally, use Try this rule in the form to test the unsaved rule together with your other rules.
  9. Click Create Rule. The rule is turned on right away.

Try auto-moderation rules before you rely on them

Click Try your rules above the rule list. Choose how the text is Posted as (post, comment, blog, or event) and a Space, or No space (site-wide rules only). Enter a Title and Text, then click Try it.

The result shows what would happen and which rule decided it, plus every rule that matched. If nothing matches, you see "No rule matched: this would be posted." Only enabled rules run. Nothing is posted or recorded, so it's safe to try new keywords here.

See what Block rules refused

The Blocked tab lists posts, comments, blogs, and events that a Block rule refused, with the Content, Author, Rule, and When. Edit refused marks a refused edit. Only the rule that decided is listed, and entries are kept for 30 days. Filter by rule, or click See what this rule held in Pending Content.

Add many keyword rules at once

Click Bulk add keywords and paste your words, separated by commas or new lines. Then choose the Action, Applies to, Scope, and Priority they share, and click Add N keywords. Each word becomes its own keyword rule. The dialog removes duplicates and warns you if the batch is too large or your community is running out of room for rules.

Turn off, edit, or delete an auto-moderation rule

  • Use the switch next to a rule to turn it on or off.
  • Open the rule's ⋯ menu and choose Edit or Delete. Deleting a rule can't be undone.

If every space a rule applied to is deleted, the rule is turned off and says why. Choose other spaces, or make it community-wide, before you turn it back on.

Keywords that need review in a single space

Space admins can filter words in one space. Open the space, click Manage, then Auto-moderation (previously Moderation rules, as the app still calls it), and add words under Keywords that need review (previously Blocked Keywords). Posts and replies that contain them wait for approval in the space's review queue. Chat spaces don't have this setting.

Mateflow saves these words as Hold for review keyword rules scoped to that space, so they also appear on the Rules tab. If a keyword's rule is turned off there, the space shows it as Off. If its action was changed, it shows Reject or Notify only. Greyed-out keywords come from a community rule that covers several spaces, and the section also says how many community-wide rules apply to the space. Change those on Automated Moderation.

In the app, the words sit under Blocked keywords. Below the box, the app lists keywords that are "Turned off, not checked", "Rejected outright", or "Published, moderators notified", and shows the same count of community-wide rules.

Related articles

Was this guide helpful?

Back to guides

Can't find what you need?

If you're a member of a community, its admins are the right people to ask. If you're building or running one on Mateflow, our team can help.