Review

Avaliações públicas da loja e do produto.

Uma avaliação mapeada por mapReview. O cliente não filtra status. O que a rota pública devolver entra na lista.

Disponível em

• ✅ storefront.reviews.list() / summary()
• ✅ Contexto PDP com data: ['reviews', 'product']
• ✅ reviews_summary no layout da PDP
• ✅ Action storefront.reviews.create() (cliente envia review)

Review

Campo	Tipo	Descrição
id	string	UUID
authorName	string	Nome exibido
authorAvatarUrl	string | null	Avatar
rating	number	1–5
title	string | null	Título curto
body	string | null	Texto da avaliação
mediaUrls	string[]	Fotos/vídeos
isVerifiedPurchase	boolean	Compra verificada
productId	string | null	null = review da loja
createdAt	string	ISO
publishedAt	string | null	ISO

ReviewsSummary

Campo	Tipo
averageRating	number
totalReviews	number
distribution	{ "1": n, "2": n, … "5": n }
verifiedCount	number

productId na API pública

Valor	Comportamento
omitido	Reviews da loja (product_id = null)
UUID / slug	Reviews do produto
'all' / scope: 'all'	Loja + todos os produtos

Exemplo — listagem

const { reviews, summary } = await storefront.reviews.list({
  product: page.product,
  first: 10,
  sort: 'recent',
});

reviews.nodes.map((review) => (
  <article key={review.id}>
    <strong>{review.authorName}</strong>
    <span>{'★'.repeat(review.rating)}</span>
    <p>{review.body}</p>
  </article>
));

Exemplo — resumo (layout PDP)

const reviews_summary = await storefront.reviews.summary({
  product: page.product,
});

// reviews_summary.averageRating, .totalReviews

Relacionado

Veja reviews.list, Product Reviews Cookbook e Mapa de dados.