# Shadcn Review blocks

> Customer review and rating components with star ratings, comments, and review forms.

- Type: Pro blocks (eCommerce)
- Page: https://web.dev.reui.io/blocks/ecommerce/review
- Docs (Base UI): https://web.dev.reui.io/docs/components/base/rating.md
- Docs (Radix UI): https://web.dev.reui.io/docs/components/radix/rating.md
- Blocks: 6
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## When to use

- Customer reviews on a product page: stars, reviewer avatars and a link to all reviews
- Buyer quotes as social proof, rotating in an auto playing slider or set out in a static grid
- A ratings overview with the average score, star distribution bars and the topics buyers mention

## When not to use

- A slider of product photos or promo slides with no buyer quotes in it: use [Carousel](https://web.dev.reui.io/components/carousel.md) (`get_component("carousel")`)
- A star score on its own, or a star input inside a form with no review text: use [Rating](https://web.dev.reui.io/components/rating.md) (`get_component("rating")`)
- Rows of metrics, transactions or integrations with a figure or button on each: use the [List blocks](https://web.dev.reui.io/blocks/application/list.md)

## Agent notes

- Every `Reviews` root takes no props and reads `PRODUCT` plus `REVIEWS` or `TESTIMONIALS` from data.ts; add props to pass in your own product
- `PRODUCT.reviewCount` is a fixed 1284, not the length of the 3 to 6 reviews each block renders; set it from your review total
- Reviewer names link to `authorHref` and the review count to `PRODUCT.allReviewsHref`, both demo hash anchors to point at your routes

## Third-party libraries

- Embla Carousel v8: [API reference](https://www.embla-carousel.com/docs/v8/api), [docs](https://www.embla-carousel.com/docs/v8/get-started/react), used by 3 of 6 blocks
- Embla Carousel Autoplay v8: [API reference](https://www.embla-carousel.com/docs/v8/plugins/autoplay), [docs](https://www.embla-carousel.com/docs/v8/plugins), used by 3 of 6 blocks

## Blocks

- [Avatar Review Carousel](https://web.dev.reui.io/blocks/ecommerce/review/review-1.md): Product reviews carousel with autoplay slides and avatar thumbnail navigation. Best for one 2 paragraph review per slide, with a reviewer bar that tracks the active slide and an overlapping avatar stack to jump between them.
- [Topic Filter Reviews](https://web.dev.reui.io/blocks/ecommerce/review/review-2.md): Customer Reviews Section with Sentiment Topic Filter Chips and Two-Column Review Grid. Best for topic chips with a percent score above a 2 column grid of headlined reviews, each with a thumbs up helpful count.
- [Rating Summary Reviews](https://web.dev.reui.io/blocks/ecommerce/review/review-3.md): Customer reviews section with rating summary sidebar and sortable review list. Best for a summary card of the average score, star distribution bars, recommend rate and mention tags beside a list with a sort select.
- [Pull-Quote Reviews](https://web.dev.reui.io/blocks/ecommerce/review/review-4.md): Ecommerce Customer Reviews Pull-Quote Highlights Grid With Star Ratings and Avatars. Best for a static 3 column wall of short quotes with no carousel or client state, each signed with avatar, stars, score and post date.
- [Testimonial Carousel](https://web.dev.reui.io/blocks/ecommerce/review/review-5.md): Ecommerce Product Testimonial Carousel with Autoplay and Dot Pagination. Best for quote mark cards with the reviewer role and stars on one line under the name, up to 3 in view at once.
- [Star-Led Reviews](https://web.dev.reui.io/blocks/ecommerce/review/review-6.md): Auto-playing customer review carousel with star-rating-led testimonial cards and dot pagination. Best for compact cards led by the stars, with a divider above a small avatar, the name and a role line.

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.