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

# Product Reviews and Rating Moderation

> Enable customer reviews globally or per product, moderate submissions in the approval queue, and connect third-party platforms like Yotpo or Trustpilot.

Product reviews build social proof and help shoppers make confident buying decisions. Site Store Pro includes a native review system with a moderation queue, per-product controls, and support for third-party review platforms — giving you full control over how ratings and feedback appear on your storefront.

## Enable Reviews Globally

The global reviews toggle acts as the master switch. When it is off, review tabs, star rating badges, and submission forms are hidden across every page of your store, regardless of individual product settings.

Navigate to **Admin → Global Settings → Reviews Settings** and toggle **Enable Product Reviews** to activate the reviews system sitewide.

| Setting                    | Description                                                                                                                                                                                     |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Enable Product Reviews** | Master switch for all review UI elements across the storefront.                                                                                                                                 |
| **Third-Party Reviews JS** | Paste a JavaScript snippet from Yotpo, Trustpilot, Stamped.io, or another provider to replace the native review widget. See [Third-Party Integrations](#third-party-review-integrations) below. |

***

## Enable or Disable Reviews Per Product

With global reviews enabled, you can still turn off reviews for individual products — for example, items that are too new to have feedback, or products where reviews aren't appropriate (such as gift cards or configurable services).

Open the product editor and toggle **Allow Customer Reviews**. Disabling this toggle hides the review tab and submission form for that product only, while leaving the reviews system fully active for all other items in your catalog.

<Note>
  Reviews are always subject to the global toggle first. If **Enable Product Reviews** is off at the global level, the per-product **Allow Customer Reviews** setting has no effect — no reviews will appear anywhere on the storefront until you re-enable the global setting.
</Note>

***

## Moderation and Approval Queue

All customer-submitted reviews enter a **pending** state and are not visible on your storefront until you approve them. This gives you the opportunity to read every review before it goes live.

Navigate to **Admin → Shop → Reviews** (`/admin/ecommerce/reviews`) to access the approval queue.

<Note>
  Every review is held in pending status after submission. No customer review appears publicly on your store until an admin explicitly approves it. This prevents spam, inappropriate content, and competitor manipulation from reaching your shoppers.
</Note>

### Approving a Review

<Steps>
  <Step title="Open the Reviews Queue">
    Go to **Admin → Shop → Reviews**. Pending reviews are listed at the top with a **Pending** status badge.
  </Step>

  <Step title="Read the Submission">
    Click on a review to read the full text, star rating, reviewer name, and the product it was submitted for.
  </Step>

  <Step title="Approve or Discard">
    Click **Approve** to publish the review. Site Store Pro immediately recalculates the product's average star rating (on a 1.0–5.0 scale) and updates the total review count. If the review violates your guidelines, leave it in pending or delete it.
  </Step>
</Steps>

Once approved, star ratings update instantly across all affected touchpoints:

<CardGroup cols={2}>
  <Card title="Catalog Cards" icon="grid">
    The average star rating badge on the product card in category and search results pages reflects the new average immediately.
  </Card>

  <Card title="Product Buy Box" icon="star">
    The star rating and review count shown in the buy box on the product detail page update in real time after approval.
  </Card>
</CardGroup>

***

## Third-Party Review Integrations

If you use an external review platform such as Yotpo, Trustpilot, or Stamped.io, you can replace Site Store Pro's native review widget with your provider's JavaScript snippet. This lets you consolidate reviews in your third-party platform while still displaying them seamlessly on your storefront.

<Steps>
  <Step title="Get Your Embed Snippet">
    Log in to your review provider's dashboard (Yotpo, Trustpilot, Stamped.io, etc.) and copy the JavaScript embed code they provide for your store.
  </Step>

  <Step title="Paste the Snippet">
    Navigate to **Admin → Global Settings → Reviews Settings** and paste the JavaScript into the **Third-Party Reviews JS** field.
  </Step>

  <Step title="Save and Verify">
    Save your settings. The third-party widget overrides the native review tab on product detail pages. Visit a product page to confirm the integration renders correctly.
  </Step>
</Steps>

<Warning>
  When a third-party reviews snippet is active, Site Store Pro's native approval queue is bypassed for display purposes. Moderation and approval of reviews happens inside your third-party platform's dashboard, not in **Admin → Shop → Reviews**. Make sure you configure moderation settings within your review provider before going live.
</Warning>

<Tip>
  You can keep **Enable Product Reviews** toggled on globally while using a third-party widget. The native moderation queue remains available for reference, but the storefront displays only your third-party provider's widget.
</Tip>