Product Reviews

Add customer reviews to your products to build trust and increase conversions.

Features

Feature Description
Review management Add, edit, approve, decline, and delete reviews
Bulk actions Approve, decline, or delete multiple reviews at once
CSV import Import reviews in bulk via CSV upload
Auto-approve Automatically approve new reviews
Verified purchases Badge for reviews from confirmed buyers
Rating display Configurable star ratings on product pages
Public API JSON API endpoint for headless or custom integrations
Theme integration Custom Liquid sections and variables for theme builder

Prerequisites

Before setting up, you need:

  • Product Reviews plugin activated from Settings > Plugins

Setting Up

  1. Navigate to Settings > Plugins
  2. Find Product Reviews
  3. Click Activate
  4. Navigate to Plugins > Product Reviews
  5. Configure your review settings (see below)

Settings

Setting Description
Auto-approve reviews Automatically approve new reviews without manual moderation
Require email Require an email address when submitting a review
Minimum rating to display Only show reviews at or above this star rating
Show unverified reviews Display reviews that are not linked to a verified purchase

Managing Reviews

Viewing Reviews

  1. Navigate to Plugins > Product Reviews
  2. Browse all reviews with filtering and sorting
  3. Filter by status (approved, pending, declined)
  4. Search by product SKU, customer name, or review content

Adding a Review

  1. Click Add Review
  2. Fill in reviewer details (name, email)
  3. Select the product SKU
  4. Enter title, body, and star rating (1-5)
  5. Set status (approved, pending, or declined)
  6. Save the review

Bulk Actions

Select multiple reviews and apply actions:

  • Approve — Publish selected reviews
  • Decline — Hide selected reviews
  • Set to Pending — Move back to moderation queue
  • Delete — Permanently remove selected reviews

CSV Import

Import reviews in bulk using a CSV file.

Import Process

  1. Click Import Reviews
  2. Download the CSV template for the correct format
  3. Upload your completed CSV file
  4. Reviews are processed automatically

Tip: For files with more than 50 rows, the import runs in the background and you'll receive an email when it completes.

CSV Format

The CSV template includes columns for:

Column Description
first_name Reviewer's first name
last_name Reviewer's last name
email Reviewer's email address
product_sku SKU of the reviewed product
title Review title
body Review body text
rating Star rating (1-5)
verified_purchase Whether the review is a verified purchase (true/false)

Theme Integration

Product Reviews integrates with the theme builder through custom Liquid sections and variables.

Liquid Variables

Two custom Liquid variables are available on product pages:

  • {{ product.rating }} — Outputs inline SVG star rating
  • {{ product.rating_full }} — Outputs stars plus a text summary (e.g., "4.2 (37 reviews)")

Both return an empty string if no reviews exist for the product.

For full usage details, examples, and styling options, see Liquid Variables.

Custom Sections

The Product Reviews plugin provides custom theme sections that can be added to your storefront through the visual editor. These sections automatically display reviews and ratings for products.

Public API

The Product Reviews plugin exposes a public JSON API for fetching reviews.

Endpoint

GET /api/reviews?sku={product_sku}

Parameters

Parameter Description
sku Product SKU to fetch reviews for

Response

The API returns individual reviews along with a rating summary including average rating and total review count.

Troubleshooting

Reviews Not Displaying

Symptoms: Reviews are approved but not showing on the storefront

Solutions:

  • Verify the plugin is activated
  • Check that reviews are in Approved status
  • Ensure the minimum rating threshold isn't filtering them out
  • Confirm your theme includes the review section or Liquid variables

CSV Import Failing

Symptoms: Import errors or reviews not appearing after import

Solutions:

  • Download and use the provided CSV template
  • Ensure product SKUs match existing products
  • Check that ratings are between 1 and 5
  • Verify email format if "Require email" is enabled