Skip to main content

Product Reviews

Admin

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​

  1. A customer visits a product detail page on your storefront.
  2. They click Write a Review.
  3. They sign in (or create an account) if not already authenticated.
  4. They complete the review form:
FieldRequiredDescription
Star RatingYes1 to 5 stars.
TitleNoA short headline for the review (max 200 characters).
BodyNoThe detailed review text (max 2,000 characters).
  1. The review is submitted and enters the moderation queue.
Verified purchase badge

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​

  1. Navigate to /admin/product_reviews (this page is accessible by direct URL).
  2. The reviews list shows submitted reviews. Filter by Pending or Approved using the status filter. (There is no "Rejected" status — see below.)
  3. Pending reviews are those with approved: false.

Approving a Review​

  1. Click on a pending review to view the full content.
  2. Review the star rating, title, body, and customer information.
  3. Click Approve to publish the review on the storefront.

Rejecting a Review​

  1. Click Reject on a pending review.
  2. The review is permanently deleted from the database.
Rejection is permanent

Clicking Reject destroys the review record entirely — it is NOT kept in the system. There is no "Rejected" status or soft-delete. If you want to preserve a review but hide it, there is no built-in mechanism for this; you can only approve or delete.

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 (/admin/product_reviews), you can:

  • Filter by status (Pending or Approved) to focus on reviews that need attention.
  • Approve pending reviews to publish them on the storefront.
  • Delete any review (approved or pending) to permanently remove it.

Note: since rejection deletes reviews, you cannot "un-reject" a review. Approved reviews can be deleted at any time, which removes them from the storefront.

What's Next?​