> ## Documentation Index
> Fetch the complete documentation index at: https://docs-loja.usecorvex.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Product Reviews

> Cookbook — listagem de avaliações na PDP com reviews.list e resumo agregado.

> Quero exibir avaliações aprovadas na página de produto. Como implementar?

Referência: `seu tema (adaptado do cookbook)`

Índice: [Cookbooks](https://docs-loja.usecorvex.com.br/cookbook/overview.md)

***

## Contratos utilizados

* [Review resource](https://docs-loja.usecorvex.com.br/data/resources/review.md)
* [reviews.list](https://docs-loja.usecorvex.com.br/data/queries/reviews-list.md)
* [Data Contract](https://docs-loja.usecorvex.com.br/reference/contracts/data.md) — `reviews` data key
* `@corvex/theme-sdk` — `defineSectionData`, `storefront.reviews.list`

***

## API pública

```jsx theme={"theme":{"light":"github-light","dark":"github-dark"}}
const result = await storefront.reviews.list({
  product: page.product,
  first: 10,
  sort: 'recent',
});
```

| Campo | Uso |
| - | - |
| `result.reviews.nodes` | Lista de `Review` |
| `result.summary.averageRating` | Média 1–5 |
| `result.summary.totalReviews` | Total aprovadas |

O cliente não filtra status. Se a lista só traz avaliações aprovadas, a regra é da API.

***

## Fluxo

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
PDP — page.product
        ↓
defineSectionData → reviews.list({ product: page.product })
        ↓
summary + lista na UI
```

`enabledOn: ['product']` · `data: ['reviews', 'product']`

***

## Campos públicos de Review

| Campo | UI |
| - | - |
| `authorName` | Nome |
| `rating` | Estrelas 1–5 |
| `title`, `body` | Título e texto |
| `isVerifiedPurchase` | Badge compra verificada |

**Não usar** campos não documentados no [Review resource](https://docs-loja.usecorvex.com.br/data/resources/review.md).

***

## Enviar avaliação (action separada)

`storefront.reviews.create()` — ver [reviews.create](https://docs-loja.usecorvex.com.br/data/actions/reviews-create.md). Este cookbook cobre **listagem** apenas.

***

## Checklist

* [ ] `product: page.product` na PDP
* [ ] `summary` + `reviews.nodes` na UI
* [ ] `corvex validate .`

***

## Veja também

* [Featured Product](https://docs-loja.usecorvex.com.br/cookbook/featured-product.md)
* [Product Recommendations](https://docs-loja.usecorvex.com.br/cookbook/product-recommendations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.