Product Reviews
Product reviews let customers share feedback on products they have purchased from your storefront. Reviews include a star rating, title, and written comment. All reviews require admin approval before they appear publicly, giving you full control over what is displayed.
How Customers Leave Reviews
- A customer visits a product detail page on your storefront.
- They click Write a Review.
- They sign in (or create an account) if not already authenticated.
- They complete the review form:
| Field | Required | Description |
|---|---|---|
| Star Rating | Yes | 1 to 5 stars. |
| Title | Yes | A short headline for the review. |
| Body | Yes | The detailed review text. |
- The review is submitted and enters the moderation queue.
Customers who have previously purchased the product receive a Verified Purchase badge on their review. This badge is assigned automatically based on order history -- it cannot be manually applied or removed.
Moderation Workflow
All reviews require approval before they appear on the storefront. No reviews are published automatically.
Reviewing Submitted Reviews
- Navigate to Reviews in the admin navigation.
- The reviews list shows all submitted reviews with their status: Pending, Approved, or Rejected.
- Pending reviews are highlighted for your attention.
Approving a Review
- Click on a pending review to view the full content.
- Review the star rating, title, body, and customer information.
- Click Approve to publish the review on the storefront.
Rejecting a Review
- Click on a pending review.
- Click Reject to prevent the review from appearing on the storefront.
Rejected reviews are kept in the system for your records but are never displayed to customers.
Where Reviews Appear
Once approved, reviews are visible in two places on the storefront:
Product Cards
Product cards on the menu and category pages display an average star rating beneath the product name. This gives customers a quick sense of product quality while browsing.
Product Detail Pages
The full product detail page shows:
- Average star rating with the total number of reviews.
- Individual reviews listed below the product description, each showing the reviewer name, star rating, title, body, date, and verified purchase badge (if applicable).
SEO Benefits
Approved reviews automatically generate aggregateRating structured data (schema.org markup) on product detail pages. This means search engines like Google can display star ratings directly in search results, which can improve click-through rates and visibility for your storefront.
Managing Reviews
From the Reviews admin page, you can:
- Filter by status (Pending, Approved, Rejected) to focus on reviews that need attention.
- Filter by product to see all reviews for a specific item.
- Search by customer name or review content.
- Change status -- you can reject a previously approved review or approve a previously rejected one at any time.
What's Next?
- Product Image Gallery -- Add multiple images to product detail pages.
- Storefront -- Overview of storefront setup and configuration.
- Managing Products -- Edit product details and descriptions.