# ReviewList

> Sortable, filterable, paginated review list with optional media and helpful votes

Canonical URL: https://c22dfdd27662:3005/islands/social-proof/review-list

> Full review-list experience for PDPs and landing pages that need richer social proof than a carousel.

## Preview

**Category**: Social Proof

## Props

| Prop | Type | Required | Default | Description |
|------|------|----------|---------|-------------|
| reviews | array | no | - | Inline review records |
| reviewsEndpoint | string | no | - | Advanced override only. The page supplies the reviews endpoint at runtime; do not set this |
| collectionId | string | no | - | Limits endpoint results to one Lexsis review collection |
| reviewSnapshotId | string | no | - | Uses the immutable collection snapshot prepared for an experiment arm |
| productIds | array | no | - | Optional Shopify product ids to filter endpoint results |
| variant | enum | no | stamped | `minimal` or `stamped` |
| averageRating | number | no | - | Summary rating |
| totalReviews | number | no | - | Summary review count |
| pageSize | number | no | 5 | Reviews shown per page |
| showDemographics | boolean | no | true | Show demographics data when available |
| showHelpful | boolean | no | true | Show helpful vote controls |
| showFilters | boolean | no | false | Show review filters |
| showSort | boolean | no | true | Show sort control |
| showMedia | boolean | no | true | Show review media |
| sort | enum | no | - | `recent`, `highest`, or `featured` |

## Embed Example

```html
<lx-island name="ReviewList">
  <script type="application/json">
{
  "collectionId": "YOUR_REVIEW_COLLECTION_ID",
  "variant": "minimal",
  "pageSize": 5,
  "showSort": true
}
  </script>
</lx-island>
```

## Usage

Use `ReviewList` for substantial review collections with sorting,
pagination, or filtering. Use [ReviewCarousel](/islands/social-proof/review-carousel)
for a compact, decorative showcase or a small number of testimonials.

To show curated Judge.me reviews, connect or import in
<AppLink to="integrations">Integrations</AppLink>, create a collection in
<AppLink to="reviews">Storefront → Reviews</AppLink>, then set `collectionId`. The page
supplies the reviews endpoint at runtime; do not set `reviewsEndpoint`. See
[Judge.me Reviews](/guides/judge-me-reviews).