> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Low-Star Reviews (1-2 stars, 30d), WooCommerce

> Low-Star Reviews (1-2 stars, 30d). The count of 1 and 2 star product reviews left on your WooCommerce store in the last 30 days, the early-warning signal for a product or fulfilment problem. How to read it, why it matters, and how to act on it.

**Card class:** [Hero](/nerve-centre/overview#card-classes-explained)  •  **Category:** [Ecommerce Platform](/nerve-centre/connectors#connectors-by-type)

> Low-Star Reviews (1-2 stars, 30d) for the selected period.

## At a glance

> A count of the 1 and 2 star product reviews left on your store in the trailing 30 days. On WooCommerce, product reviews are WordPress comments with `comment_type = review` and a rating stored in comment meta from 1 to 5. A cluster of low-star reviews is the earliest customer-voice signal that a product has a quality, sizing, or fulfilment problem, often before it shows up in refunds or returns. This card counts the low end of that distribution so the merchant can act before a one-off complaint becomes a pattern.

|                                |                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **What it counts**             | The number of product reviews with a rating of 1 or 2 (out of 5) submitted in the last 30 days. Reviews with a rating of 3, 4, or 5 are excluded, as are non-review comments.                                                                                                                                                                                             |
| **REST API endpoint**          | `GET /wp-json/wc/v3/products/reviews`. Each review carries a `rating` field (1 to 5) and a `status` (approved / hold). Reviews are stored under the hood as WordPress comments with `comment_type = review` and the rating held in comment meta.                                                                                                                          |
| **Status treatment**           | Whether the card counts only `approved` reviews or also those on `hold` (awaiting moderation) depends on the store's moderation settings, described generally. Most stores moderate reviews, so a held 1-star review may not yet be public but is still a customer signal worth seeing.                                                                                   |
| **What qualifies as a review** | Only genuine product reviews (`comment_type = review`) with a numeric rating count. Plain blog or page comments, and review submissions with no star rating, are not included. Spam and trashed comments are excluded.                                                                                                                                                    |
| **Self-hosted vs managed-Woo** | The data is identical on self-hosted, WordPress.com, and managed-Woo (Woo.com Cloud, WP Engine, Pressable, Kinsta). Stores that route reviews through a third-party plugin (Yotpo, Judge.me, Trustpilot) may store ratings outside the native WC reviews table, in which case those reviews live in the plugin rather than `wc/v3/products/reviews`, described generally. |
| **Time window**                | `30D` (trailing 30 days)                                                                                                                                                                                                                                                                                                                                                  |
| **Alert trigger**              | `>5`, driven by `sentiment_key: wc_review_low_star_alert`                                                                                                                                                                                                                                                                                                                 |
| **Roles**                      | owner, marketing                                                                                                                                                                                                                                                                                                                                                          |

## Calculation

Calculated automatically from your WooCommerce data. See the At a glance summary above for what the metric tracks and the worked example below for a typical reading.

## Worked example

A self-hosted WooCommerce apparel store on WC 9.0 using native WooCommerce reviews with moderation enabled. The 30-day window covers 14 May 26 to 12 Jun 26.

| Rating                                | Reviews in window         | Counts in this card?           |
| ------------------------------------- | ------------------------- | ------------------------------ |
| 5 stars                               | 142                       | No                             |
| 4 stars                               | 38                        | No                             |
| 3 stars                               | 14                        | No                             |
| 2 stars                               | 6                         | Yes                            |
| 1 star                                | 3                         | Yes                            |
| Held in moderation (not yet approved) | 2 (both 1-star)           | Depends on moderation setting  |
| **Low-Star Reviews (this card)**      | **9 (approved 1-2 star)** | Above the `>5` alert threshold |

Four things to notice:

1. **Nine low-star reviews crosses the `>5` alert.** Nerve Centre flags it. The headline rating may still look healthy (142 five-star reviews dominate the average), which is exactly why a low-star count is more sensitive than [Average Product Review Rating](/nerve-centre/kpi-cards/woocommerce/average-product-review-rating): a handful of angry reviews barely moves the average but signals a real problem.
2. **Cluster on one product is the actionable read.** If seven of the nine low-star reviews are on a single SKU, that product has a defect, sizing, or description problem. The number to act on is not the store-wide total but the concentration. Reading the review text is the next step, and a great use of Ask Viq to summarise the themes.
3. **Held-in-moderation reviews are still signal.** Two more 1-star reviews are sitting in moderation, not yet public. Whether they count here depends on the store's moderation setting, but either way they are early warning the merchant should read now rather than after approval.
4. **Low-star reviews often lead the refund curve.** Customers frequently review before they request a refund. A rising low-star count this month tends to precede a rising [Refund Rate](/nerve-centre/kpi-cards/woocommerce/refund-rate) next month, so this card is a forward indicator, not just a satisfaction snapshot.

## Sibling cards merchants should reference together

| Card                                                                                                  | Why pair it with Low-Star Reviews                                                                                                            |
| ----------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [WC Average Product Review Rating](/nerve-centre/kpi-cards/woocommerce/average-product-review-rating) | The blended rating. Low-star count is the more sensitive early signal; a few angry reviews move this card long before they move the average. |
| [WC Refund Rate](/nerve-centre/kpi-cards/woocommerce/refund-rate)                                     | Low-star reviews frequently precede refund requests. A rising low-star count is a forward indicator of refund pressure.                      |
| [WC Top Refunded Products](/nerve-centre/kpi-cards/woocommerce/top-refunded-products)                 | Cross-reference to see whether the products drawing low-star reviews are the same ones driving refunds.                                      |
| [WC Refund-Driven Customer Churn](/nerve-centre/kpi-cards/woocommerce/refund-driven-customer-churn)   | Connects product dissatisfaction to lost customers, the downstream cost of unaddressed low-star reviews.                                     |
| [WC Customer Churn](/nerve-centre/kpi-cards/woocommerce/customer-churn)                               | A persistent low-star trend on a hero product erodes repeat purchase and shows up here over time.                                            |

## Reconciling against WooCommerce

**Where to look in WordPress / WooCommerce Admin:**

[WP Admin → Products → Reviews](/wp-admin/edit.php?post_type=product\&page=product-reviews) lists all product reviews with their star rating and approval status, and is the closest first-party view to this card. On older WC versions, reviews appear under [WP Admin → Comments](/wp-admin/edit-comments.php) filtered to the review type.

Other WP Admin views that touch the same data:

* **WP Admin → Comments**: the underlying store; product reviews are comments with `comment_type = review`. Filtering by type and sorting by rating reproduces this card manually.
* **The individual product edit screen → Reviews tab**: per-product review list, useful for confirming whether low-star reviews cluster on one SKU.
* **Your third-party review plugin's dashboard**: if you run Yotpo, Judge.me, or Trustpilot, those ratings may live in the plugin rather than the native WC reviews table.

**Why our number may legitimately differ from WP Admin:**

| Reason                                                                                                                                                                                                                                                                            | Direction of divergence                            |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| **Time-zone**. The 30-day window is computed in UTC; WP Admin timestamps reviews in the WP site timezone (*Settings → General → Timezone*). Reviews near a boundary day can fall on different sides.                                                                              | +/- reviews at the window boundary                 |
| **Moderation status**. Whether held (unapproved) reviews count depends on the store's moderation setting. If the card counts approved-only and WP Admin shows all, WP Admin will read higher; if the card includes held reviews, it may read higher than the public-facing count. | Either, depending on moderation setting            |
| **Third-party review plugin**. If reviews are captured by Yotpo, Judge.me, or Trustpilot rather than native WC, those ratings live in the plugin and may not appear in `wc/v3/products/reviews`. The native count will then understate total low-star feedback.                   | Ours lower than the plugin's total                 |
| **Self-hosted uptime / sync lag**. A recently submitted review may not be indexed until the next successful poll, so the very latest reviews can appear in WP Admin before the card.                                                                                              | Ours temporarily lower; self-resolves at next sync |
| **Spam / trashed handling**. Reviews marked spam or trashed are excluded here. A raw WP Admin count that includes the spam queue will read higher.                                                                                                                                | Ours lower than an unfiltered comment count        |

## Known limitations / merchant FAQs

**My average rating still looks great, why is this card alerting?**
Because a low-star count is far more sensitive than an average. A store with hundreds of five-star reviews can absorb several one-star reviews with barely a dent in its average, while those few angry reviews are exactly the signal you need to catch. This card exists to surface the problem the average hides. Read it alongside [Average Product Review Rating](/nerve-centre/kpi-cards/woocommerce/average-product-review-rating), not instead of it.

**Do held (unmoderated) reviews count?**
It depends on your store's review moderation setting. Many stores hold all reviews for approval, in which case a 1-star review may be a customer signal before it is ever public. Whether the card counts held reviews or approved-only follows that configuration. Either way, a held low-star review is worth reading now, not after approval.

**I use Yotpo / Judge.me / Trustpilot, why is the count low?**
Third-party review plugins often store ratings outside the native WooCommerce reviews table, so they may not appear in `wc/v3/products/reviews`. If most of your reviews flow through such a plugin, this card reflects only native WC reviews and will understate your true low-star volume. Check your review plugin's own dashboard for the complete picture.

**How do I act on a spike?**
Look for concentration. A store-wide total is less useful than knowing the low-star reviews cluster on one or two SKUs. Open those products, read the review text (Ask Viq can summarise the themes for you), and decide whether it is a product defect, a sizing or description issue, or a fulfilment problem. Then cross-check [Top Refunded Products](/nerve-centre/kpi-cards/woocommerce/top-refunded-products) to see if the same SKUs are driving refunds.

**Can fake or competitor reviews inflate this?**
Yes, native WC reviews can be left by anyone unless you restrict reviews to verified buyers (WooCommerce → Settings → Products → "Reviews can only be left by verified owners"). Enabling that setting reduces spam and competitor noise, and makes this card a cleaner signal of genuine customer sentiment.

**How fresh is the data?**
The card refreshes on the standard sync, typically hourly on a self-hosted store. A review submitted moments ago may take until the next poll to appear. Because the window is 30 days, the count is stable and a single late review will not change the alerting picture materially.

***

### Tracked live in Vortex IQ Nerve Centre

*Low-Star Reviews (1-2 stars, 30d)* is one of hundreds of KPI pulses Vortex IQ tracks across WooCommerce and 70+ other ecommerce connectors. Nerve Centre runs the detection layer; Vortex Mind investigates the cause when something moves; Ask Viq lets you interrogate any number in plain English.

[Start for free](https://app.vortexiq.ai/login) or [book a demo](https://www.vortexiq.ai/contact-us) to see this metric running on your own data.
