New: connect Claude, ChatGPT or Cursor to your WooCommerce store. See how →

StoreAgent
How to use the Review Moderation AI Task – StoreAgent
  1. Home
  2. Knowledge Base
  3. AI Agents & Features
  4. How to use the Review Moderation AI Task

How to use the Review Moderation AI Task

Approving every customer review by hand takes time, and a spam review that slips through makes your store look untrustworthy. The Review Moderation AI Task reads each new product review and gives it a confidence score. If you allow it, the AI Task also publishes clean reviews and trashes obvious spam, so you only look at the edge cases. This article shows you how to turn the AI Task on, set the auto-approve and auto-reject thresholds, choose where moderation emails go, and act on reviews that need your decision.

Prerequisites

  • StoreAgent AI for WooCommerce installed, activated, and connected to your StoreAgent.ai account.
  • WooCommerce with product reviews enabled (WooCommerce → Settings → Products → Enable product reviews).
  • StoreAgent plugin v1.1.4 or later.

Step 1: Enable the Review Moderation AI Task

  1. Go to StoreAgent → Settings → AI Content Tools in your WordPress admin.
  2. Find the Review Moderation AI card and toggle the switch on.
StoreAgent → Settings → AI Content Tools tab showing the grid of AI Task cards

Once enabled, every new product review submitted on your storefront is held before it is published. The AI Task checks the text for spam patterns, inappropriate language, and signs of fake content. Then it either holds the review for you (the default) or publishes or trashes it for you (if you turn on the thresholds below).

Step 2: Configure auto-approval (optional)

Auto-approval lets the AI Task publish clean reviews without your involvement, when its confidence is high enough.

  1. On the Review Moderation AI card, click SETTINGS, then open the Settings tab.
  2. Toggle Auto-Approve Reviews on.
  3. Drag the Auto-Approve Threshold slider (default 80). The slider appears after you turn the toggle on. Reviews the AI Task marks as “approve” with a confidence at or above this number publish automatically.
  4. Click Save Changes.

Reviews below the threshold (or that the AI marks as “flag”) still go to your admin for a manual call.

Step 3: Configure auto-rejection (optional)

  1. Toggle Auto-Reject Reviews on.
  2. Drag the Auto-Reject Threshold slider (default 20). The slider appears after you turn the toggle on. Reviews the AI Task flags with a confidence at or below this number go to the trash automatically.
  3. Click Save Changes.

Borderline reviews (between your auto-reject and auto-approve thresholds) stay on hold for your decision. This way the AI Task handles obvious 5-star praise and obvious “Buy CHEAP X at sketchy-link.com” spam, and you only review the cases in the middle.

Review Moderation AI settings with Auto-Approve and Auto-Reject toggles, Custom Blacklist and Whitelist text areas

Step 4: Add custom blacklist or whitelist (optional)

The AI Task scores every review on its own. You can also give it words or phrases to watch for (blacklist) or to treat more leniently (whitelist).

  • Custom Blacklist: one word or phrase per line. Reviews that contain one of these are flagged.
  • Custom Whitelist: one word or phrase per line. Reviews that contain one of these are treated more leniently.

Click Save Changes after editing either list.

Step 5: Acting on held reviews

Reviews held for your decision appear in three places: the WordPress Comments screen (with Pending status), the Products → Reviews list, and the StoreAgent → Dashboard as a purple decision notification with the AI’s reasoning attached.

  1. Go to StoreAgent → Dashboard.
  2. Find a “Product review flagged for moderation” notification in the Pending decisions & updates panel.
  3. Read the AI’s reasoning, the flagged issues, and the confidence score, then click Accept to publish the review or Reject to send it to trash.
Decision notification on the StoreAgent dashboard from Review Moderation AI showing the flagged review with confidence score and Accept/Reject buttons

See Understanding the StoreAgent dashboard for the full guide to acting on decision notifications.

Check the AI result in the Reviews list

Every review the AI Task has checked shows its result in the AI Moderation column. Open Products → Reviews to see it. The same column also appears on the WordPress Comments screen, where it shows a dash for anything that is not a product review.

The AI Moderation column on the Products → Reviews list showing Flagged and Approved reviews with confidence scores, flags, and summaries

For each checked review, the column shows:

  • A status badge: Pending, Approved, Flagged, or Rejected.
  • The confidence score as a percentage. It stays hidden while the status is Pending.
  • Red tags for the issues the AI Task found, such as promotional content or repetitive wording.
  • A short summary of the AI Task’s reasoning, cut to about 15 words.

Each status means this:

  • Pending: the AI Task has not finished checking the review yet. Reload the page after a short wait.
  • Approved: the review is published. The AI Task auto-approved it, or you clicked Accept on the dashboard.
  • Flagged: the review is held for your decision. You also see this status when Auto-Approve Reviews is off, even if the AI Task thought the review was fine.
  • Rejected: the review is in the trash. The AI Task auto-rejected it, or you clicked Reject on the dashboard. Open the Trash view to find it.

A dash in the column means the AI Task has not checked that review. This is the case for reviews submitted before you turned the AI Task on.

The column is for reading only and has no buttons. To act on a held review, use Accept and Reject on the dashboard, or the standard Approve, Spam, and Trash links under the review text. If you use the Approve link, the badge keeps showing the AI Task’s result, for example Flagged. To see the full result, click Edit. The AI Review Moderation box on that screen lists the Status, AI Decision, Confidence, Moderated On date, Flags, AI Summary, and Reasons.

Step 6: Choose where moderation emails go (optional)

WordPress normally emails the site administrator when a review waits for moderation. With the Moderation Email with AI Results setting on (the default), StoreAgent holds that email back until the AI Task finishes. Then it sends the email with the AI results added: the confidence score, the AI decision, the flags, the reasons, and a short summary. This way you can decide from your inbox.

By default the email goes to the standard WordPress recipients. To send it to a different address, such as a shared support mailbox, follow these steps.

  1. Go to StoreAgent → Settings → AI Content Tools, click SETTINGS on the Review Moderation AI card, then open the Settings tab.
  2. Make sure Moderation Email with AI Results is on. The Send notifications to field appears below it only while the toggle is on.
  3. Type the address in Send notifications to.
  4. Click Save Changes.
Review Moderation AI settings showing the Moderation Email with AI Results toggle on and the Send notifications to field filled in with a demo address

Keep these points in mind:

  • The field takes one email address. Do not add several addresses separated by commas.
  • Leave the field empty to keep the default WordPress recipients.
  • The address applies only to product review emails. Other WordPress comment emails are not changed.
  • WordPress sends these emails only when Email me whenever has A comment is held for moderation ticked in Settings → Discussion.
  • The custom address is available in StoreAgent v1.2.2 and later.

If you type an address that is not valid, the field shows “Please enter a valid email address.” and the settings do not save until you fix it.

Troubleshooting

New reviews publish without moderation

Confirm Review Moderation AI is turned on in StoreAgent → Settings → AI Content Tools. Then open Settings → Discussion in WordPress and check the Comment Moderation options. If those are fine, check that no other plugin changes the review’s approval status before StoreAgent does. The AI Task holds each review with the pre_comment_approved filter.

Auto-approve isn’t kicking in even for clean reviews

Confirm Auto-Approve Reviews is toggled on and the threshold is sensible (try 70 if 80 is too strict). The AI Task only auto-approves when its decision is “approve” and its confidence is at or above the threshold. Reviews the AI Task flags never auto-approve, whatever the confidence.

A legitimate review was auto-rejected

Go to Comments → Trash, find the review, and click Restore. Then add a phrase from the review to your Custom Whitelist so similar reviews aren’t rejected in future. Lowering the Auto-Reject Threshold also reduces false positives, at the cost of letting more borderline spam through to your manual review queue.

Moderation emails go to the wrong address or do not arrive

Check that Moderation Email with AI Results is on and that Send notifications to holds the address you want. If the field is empty, the email goes to the default WordPress recipients. Then open Settings → Discussion and make sure A comment is held for moderation is ticked under Email me whenever. WordPress sends no moderation email without it.

A review stays Pending in the AI Moderation column

Reload the Reviews list after a short wait. If the badge still says Pending, open WooCommerce → Status → Scheduled Actions and search for saai_review_moderation. Check that the action for your review is not stuck or failed. The AI Task checks each review in the background, so the badge changes only after that action finishes.

Frequently asked questions

Does it moderate existing reviews retroactively?

No. Only new reviews submitted after you turn the AI Task on are moderated. Older reviews show a dash in the AI Moderation column. To audit existing reviews, do a one-time pass via the WordPress Comments screen.

Does each review cost credits?

Yes. Each review the AI Task analyses costs credits from your StoreAgent.ai plan.

Can the AI Task edit review text?

No. The AI Task only decides whether to publish, hold, or trash a review. It never rewrites the review text. What shoppers wrote is what gets published if you click Accept.

Can I send moderation emails to more than one address?

The Send notifications to field takes one address. To reach several people, use a shared mailbox or a group address that forwards to them.

Need help?

If you have a question or run into any issues, we’re here to help.

Was this article helpful?

Related Articles

StoreAgent

PO BOX 4362
Gumdale QLD 4154
Australia

Explore
Resources & Help
Product
Our Brands

© 2026 Rymera Web Co Pty Ltd. All Rights Reserved. ABN 51 604 474 213. Privacy Policy · Terms of Service · Data Processing Addendum · Affiliate Disclosure