> ## 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. # Average Product Review Rating, WooCommerce > Average Product Review Rating. The mean star rating across approved customer reviews on your WooCommerce catalog. How to read it, why it matters, and how to act on it. **Card class:** [Non-Hero](/nerve-centre/overview#card-classes-explained) • **Category:** [Ecommerce Platform](/nerve-centre/connectors#connectors-by-type) > Average Product Review Rating for the selected period. ## At a glance > The mean star rating customers have left across your products, on the familiar 1 to 5 scale. WooCommerce stores reviews as WordPress comments of type `review` with a star value in the `rating` comment-meta field. This card averages the `rating` of every approved review in the window, giving you a single number for catalog sentiment that doubles as a conversion and trust signal. | | | | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **What it counts** | The arithmetic mean of the `rating` meta value across all reviews whose comment status is approved, for reviews left in the selected window. Each approved review contributes its 1 to 5 star value once. | | **REST API endpoint** | `GET /wp-json/wc/v3/products/reviews`. Fields used: `rating` (integer 1 to 5), `status` (must be `approved`), and `date_created_gmt`. Under the hood these are WordPress comments with `comment_type = review` and a `rating` comment-meta row. | | **Approval / status treatment** | **Counts only approved reviews.** Comments in `hold` (pending moderation), `spam`, or `trash` are excluded. WooCommerce can be set to auto-approve or to hold reviews for moderation under Settings → Comments; that setting directly affects how quickly a new review lands in this average. | | **Verified-owner filter** | WooCommerce can require the reviewer to be a verified purchaser (Settings → Products → "Reviews can only be left by verified owners"). When that is on, only verified-buyer reviews exist to average. The card averages whatever approved reviews exist regardless of verified status. | | **Unit / scale** | A number on the **1 to 5 star scale**, rendered as a gauge. A reading near 5.0 is excellent; the alert watches the low end. | | **Self-hosted vs managed-Woo** | Identical across self-hosted LAMP, WordPress.com Business and Commerce plans, and managed-Woo hosts (Woo.com Cloud, WP Engine, Pressable, Kinsta). Reviews live in the WordPress comments table either way. | | **Third-party review plugins** | Stores using Yotpo, Judge.me, Trustpilot, or similar may keep ratings outside the native comments table. Those are NOT averaged here unless the plugin syncs back into native WooCommerce reviews. See the FAQs. | | **Time window** | `30D` (the rolling 30-day average by default) | | **Alert trigger** | `<4.0`, driven by `sentiment_key: wc_avg_review_rating` | | **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 skincare brand on self-hosted WooCommerce 8.5 with native reviews and verified-owner reviews switched on. The 30-day window covers 14 Mar 26 to 12 Apr 26. | Star value | Approved reviews in window | Contribution to total | | ----------------------- | -------------------------- | --------------------- | | 5 star | 142 | 710 | | 4 star | 38 | 152 | | 3 star | 11 | 33 | | 2 star | 6 | 12 | | 1 star | 9 | 9 | | **Approved total** | **206** | **916** | | **Average (this card)** | | **4.45** | Plus, not counted: 14 reviews sitting in moderation (`hold`) and 3 caught as spam. Four things to notice: 1. **The average is 916 / 206 = 4.45.** Comfortably above the `<4.0` alert line, so the card sits green. The brand is in healthy territory, but the trend matters more than the snapshot, a slow slide from 4.6 to 4.45 is worth watching even while still above threshold. 2. **The 14 held reviews are invisible until approved.** If your store holds reviews for moderation, a fresh wave of 1-star reviews will not move this card until someone approves them. A merchant who never clears the moderation queue can have a misleadingly high average. Keep the queue current so the number reflects reality. 3. **The 1 and 2 star reviews are the action list.** Nine 1-star and six 2-star reviews are dragging the average down. Pull them up with [Low-Star Reviews (1-2 stars, 30D)](/nerve-centre/kpi-cards/woocommerce/low-star-reviews-1-2-stars-30d) to read the actual complaints, which is where product or fulfilment fixes come from. 4. **Verified-owner mode shapes the pool.** Because verified-owner reviews are on, every one of these 206 came from a real purchaser, which makes the average more trustworthy but also slower to accumulate than an open-review store. Expect fewer reviews and steadier numbers. ## Sibling cards merchants should reference together | Card | Why pair it with Average Product Review Rating | | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | [WC Low-Star Reviews (1-2 stars, 30D)](/nerve-centre/kpi-cards/woocommerce/low-star-reviews-1-2-stars-30d) | The reviews actively dragging this average down. Read these to find the product or fulfilment problem behind a falling rating. | | [WC Refund Rate](/nerve-centre/kpi-cards/woocommerce/refund-rate) | Low ratings and high refunds usually point at the same product. A falling rating that precedes a refund spike is an early quality warning. | | [WC Top Products by Revenue](/nerve-centre/kpi-cards/woocommerce/top-products-by-revenue) | Cross-reference your best sellers against their ratings. A high-revenue product with a slipping rating is the most urgent fix. | | [WC Top Refunded Products](/nerve-centre/kpi-cards/woocommerce/top-refunded-products) | The products customers send back most often. Often the same SKUs pulling down the review average. | | [WC Conversion Rate](/nerve-centre/kpi-cards/woocommerce/conversion-rate) | Review rating is a conversion lever. A rating dropping under 4.0 frequently shows up as softer conversion on the affected product pages. | ## Reconciling against WooCommerce **Where to look in WooCommerce Admin:** [WP Admin → Products → Reviews](/wp-admin/edit.php?post_type=product\&page=product-reviews) (WooCommerce 6.7+) lists every product review with its star value and approval status. On older stores the same data lives under [WP Admin → Comments](/wp-admin/edit-comments.php) filtered to product reviews. Filter to **Approved** and the same 30-day window to match this card; the per-product star average shown on each product's front-end page is the same underlying data scoped to one product. Other WP Admin views that look related but are not: * **The Comments screen "All" count**: includes pending, spam, and trashed comments and mixes in blog-post comments. Always broader than this card. * **A product page's star widget**: that is the per-product lifetime average, not your 30-day catalog-wide average. It will differ. * **Products → Reviews "Pending" tab**: held reviews not yet approved. These are excluded here until approved. **Why our number may legitimately differ from WooCommerce Admin:** | Reason | Direction of divergence | | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ | | **Approval status**. This card averages only approved reviews; the Comments "All" view includes pending and spam. | Ours based on a tighter set | | **Window scope**. This card defaults to a rolling 30-day window; the per-product star average on the storefront is lifetime. | Different time scope | | **Timezone**. Review `date_created` uses WP site timezone; this card windows in UTC. Reviews near a day boundary may fall on different sides. | +/- around midnight at the window edge | | **Moderation lag**. Reviews held for moderation are invisible here until approved; once a backlog of held reviews is approved the average can step suddenly. | Ours lags an unmoderated queue | | **Third-party review plugin**. If ratings live in Yotpo / Judge.me and do not sync to native comments, they are absent from this average. | Ours lower coverage than the storefront widget that plugin renders | ## Known limitations / merchant FAQs **I use Yotpo / Judge.me / Trustpilot, why does this card not match my widget?** Those plugins typically store ratings in their own systems, not in the native WordPress comments table that WooCommerce reviews live in. This card averages native WooCommerce reviews (`comment_type = review`). If your third-party plugin is configured to sync reviews back into native WooCommerce, they will appear here; if not, they will not. Check your plugin's WooCommerce-sync setting, or reach out to [support@vortexiq.ai](mailto:support@vortexiq.ai). **Why does a wave of bad reviews not move the number right away?** If your store holds reviews for moderation (Settings → Comments → "Comment must be manually approved"), new reviews sit in `hold` status and are excluded from this average until you approve them. Keep the moderation queue current, otherwise the card reflects an artificially stale or high rating. Clearing a backlog of held 1-star reviews can drop the average in one step. **Does it only count verified purchasers?** The card averages whatever approved reviews exist. Whether those are limited to verified buyers depends on your WooCommerce setting (Settings → Products → "Reviews can only be left by verified owners"). With that on, every review is from a real purchaser and the average is more trustworthy but accumulates more slowly. **The alert fires at under 4.0, can I change that?** The trigger is `<4.0` by default, a widely used quality floor. Many merchants treat a slide toward 4.2 as the real warning line because the storefront still rounds 4.0 to four full stars. If you want a custom threshold for your catalog, contact [support@vortexiq.ai](mailto:support@vortexiq.ai). **Should I delete or hide my 1-star reviews to lift the number?** No. Genuine negative reviews build trust when surrounded by positives, and a perfect 5.0 reads as fake to shoppers. Use [Low-Star Reviews (1-2 stars, 30D)](/nerve-centre/kpi-cards/woocommerce/low-star-reviews-1-2-stars-30d) to read and respond to them, then fix the underlying product or fulfilment issue. That lifts the average honestly over time. **Why is my self-hosted store's number occasionally stale?** The Vortex IQ Woo indexer polls on a schedule. If your self-hosted host was unreachable during a poll, newly approved reviews can take until the next successful sync to register. Managed-Woo hosts rarely show this. Check WooCommerce → Settings → Advanced → REST API to confirm the Vortex IQ key is active. *** ### Tracked live in Vortex IQ Nerve Centre *Average Product Review Rating* 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.