> ## 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.

# reviews.create

> Enviar avaliação do cliente na vitrine via Theme SDK.

# storefront.reviews.create(input)

Permite que o cliente envie uma avaliação na PDP ou na loja.

***

## Input

| Campo | Obrigatório | Descrição |
| - | - | - |
| `authorName` | ✅ | Nome exibido |
| `rating` | O exemplo usa 1 a 5 | O cliente envia o número e não confere a faixa |
| `product` | Recomendado na PDP | UUID ou handle |
| `authorEmail` | — | Contato (não exibido) |
| `title` | — | Título curto |
| `body` | — | Texto da avaliação |
| `orderId` | — | Marca compra verificada quando válido |

***

## Exemplo

```js theme={"theme":{"light":"github-light","dark":"github-dark"}}
const result = await storefront.reviews.create({
  product: page.product,
  authorName: 'Maria',
  authorEmail: 'maria@email.com',
  rating: 5,
  title: 'Qualidade boa',
  body: 'Chegou rápido e a qualidade é excelente.',
});

if (result.success) {
  // review entra como pending até moderação
}
```

***

## Escopo

* ✅ Section / template (formulário na PDP)
* ❌ Block / snippet — use callback da section pai
* Rate limit aplicado pelo backend

Veja também [reviews.list](https://docs-loja.usecorvex.com.br/data/queries/reviews-list.md) e [Review (resource)](https://docs-loja.usecorvex.com.br/data/resources/review.md).


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