Reviews & Ratings
Customers can leave star ratings and written reviews on products. Ratings are aggregated into an average and displayed on the product page and in search/category listings.
Where to find it
Storefront: product detail page — review list + submission form
Admin: /commerce/reviews (moderation queue)
Enable flag: tenant.enable_reviews in tenant config
Customer-facing
On the product page:
- Average rating (X.X out of 5 with star icon)
- Total review count
- Submission form for logged-in customers
- Paginated review list
Customers can only review products they've purchased (verified purchase badge).
Admin moderation
By default, new reviews are pending and don't appear on the storefront until approved.
In /commerce/reviews:
- Filter by status (pending / approved / rejected)
- Click a review to approve or reject
- Rejections are kept for audit but hidden from customers
Aggregate rating
The product's avg_rating and review_count columns are recalculated whenever a review is approved, rejected, or deleted.
JSON-LD structured data
Approved reviews power AggregateRating schema.org markup on the product page — this is what makes star ratings show in Google search results.