Display customer reviews with ratings, dates, and reviewer info. Sortable and paginated.
The Review List widget displays approved customer reviews for a Goose Commerce product on the Product Details page. Reviews are retrieved from the Goose Commerce database and include star ratings, reviewer names, dates, and review text. The aggregate star rating is calculated from all approved reviews.
| Setting | Description | Default |
|---|---|---|
| Show Rating Summary | Display the overall average rating and review count above the list | Enabled |
| Show Rating Breakdown | Display a bar chart breakdown of 1–5 star ratings | Disabled |
| Reviews Per Page | Number of reviews to show per pagination set | 10 |
| Sort By | Default sort order: Newest, Oldest, Highest Rated, Most Helpful | Newest |
| Show Reviewer Name | Display the reviewer’s name with each review | Enabled |
| Show Reviewer Avatar | Display the reviewer’s avatar (Gravatar or placeholder) | Enabled |
| Show Date | Display the date the review was submitted | Enabled |
| Show Verified Badge | Show a Verified Purchase badge on reviews from confirmed buyers | Enabled |
| Empty State Text | Message shown when no reviews exist yet | Be the first to review this product. |
Place the Review List above the Review Form on the Product Details page so customers see social proof before being prompted to write their own review. Enable the Rating Breakdown chart to help customers understand the sentiment distribution across all reviews. Use the Verified Purchase badge to distinguish confirmed buyer reviews from other submissions, increasing shopper trust.
