# Variantes de Produto

As variantes permitem vender diferentes versões do mesmo produto — tamanhos, cores, volumes ou materiais — em um único anúncio. Cada variante tem seu próprio preço, estoque, SKU e imagens, e o cliente precisa escolher uma antes de adicionar ao carrinho.

## Quando usar variantes

Use variantes quando um produto tiver opções que afetam o preço ou o estoque. Uma camiseta vendida em P, M e G é um bom caso de uso; assim como uma vela em 200ml e 500ml, ou um par de sapatos em S, M, L e XL.

Se as opções não alteram preço nem estoque, um produto simples com características é geralmente mais prático.

## Passo 1 — Abra um produto

Abra **Products** na barra lateral do admin, escolha um produto e role até a seção **Variants** no final do formulário.

![Seção de variantes em um produto sem variantes](/features/product-variants/variants-empty.png)

Em um produto sem variantes, você verá uma breve descrição e um botão **Add Variant**. O produto em si mantém seu próprio preço, estoque e SKU enquanto nenhuma variante existir.

## Passo 2 — Adicione uma variante

Clique em **Add Variant** para abrir o formulário **Create Variant**. Título, descrição, coleção, regra de imposto e características vêm preenchidos a partir do produto pai, então você só precisa informar o que for diferente.

![Formulário Create Variant](/features/product-variants/create-variant.png)

| Campo             | Obrigatório | Observações                                                                               |
| ----------------- | ----------- | ----------------------------------------------------------------------------------------- |
| Variant Label     | Sim         | Etiqueta curta mostrada aos clientes na lista de opções (ex.: `Small`, `Red`, `500ml`)    |
| Title             | Sim         | Preenchido a partir do pai; altere se esta variante precisar de um nome diferente         |
| Slug              | Sim         | Identificador amigável para URL, gerado automaticamente a partir do título                |
| Short Description | Não         | Aparece nos cartões de produto e nos resultados de pesquisa                               |
| Description       | Sim         | Descrição completa; pode diferir do pai                                                   |
| Price             | Sim         | Preço específico desta variante                                                           |
| Previous Price    | Não         | Preço anterior opcional, exibido riscado na loja                                          |
| Stock             | Sim         | Estoque controlado independentemente das outras variantes                                 |
| SKU               | Não         | Código interno opcional, único para esta variante                                         |
| Active            | Não         | Apenas variantes ativas aparecem na loja                                                  |
| Media             | Não         | Envie imagens específicas desta variante; se omitido, usa as imagens do produto pai       |

> **Dica:** Ative **Active** quando a variante estiver pronta para venda. Variantes inativas ficam no admin para depois mas nunca aparecem aos clientes.

Clique em **Create Variant** para salvar. Você volta à página de edição do produto pai com a nova variante listada.

## Passo 3 — Gerencie as variantes

Assim que um produto tem variantes, a seção **Variants** mostra todas em uma tabela com etiqueta, preço, estoque, SKU e status.

![Lista de variantes com linhas ativas e inativas](/features/product-variants/variants-list.png)

| Coluna        | Descrição                                                                            |
| ------------- | ------------------------------------------------------------------------------------ |
| Variant Label | A etiqueta mostrada aos clientes                                                     |
| Price         | Preço da variante na moeda da loja                                                   |
| Stock         | Estoque independente desta variante                                                  |
| SKU           | SKU da variante, ou `—` se vazio                                                     |
| Status        | Distintivo **Active** ou **Inactive**                                                |
| Ações         | Botões de mover para cima, mover para baixo, editar e excluir em cada linha          |

Use as setas para reordenar as variantes — a ordem nesta tabela é a ordem que os clientes veem na loja. Clique no lápis para editar uma variante (o formulário de edição é idêntico ao de criação) e no ícone de lixeira para excluir uma. Excluir uma variante remove-a permanentemente; não há exclusão reversível.

> **Importante:** Quando um produto tem ao menos uma variante, o **Price**, **Stock** e **SKU** do pai deixam de ser usados. Esses valores passam a morar em cada variante. A dica abaixo desses campos no admin avisa o mesmo quando você está editando o pai.

## Como o cliente vê

Na loja, um produto com variantes exibe um bloco **Options** com um chip para cada variante ativa.

![Página de produto mostrando os chips de variantes e botão de checkout desabilitado](/features/product-variants/storefront-parent.png)

O botão **Add to Basket** fica desabilitado na página do pai e mostra **Select an Option** até o cliente clicar em um chip. Variantes sem estoque aparecem em cinza com tachado e não são clicáveis.

Ao clicar em um chip, o cliente é levado à página própria da variante, onde o chip fica destacado, o preço e as imagens se atualizam e o botão se torna um **Add to Basket** funcional.

![Página da variante com o tamanho M selecionado](/features/product-variants/storefront-variant.png)

A partir daí, o cliente pode trocar entre variantes irmãs clicando em outro chip ou adicionar a variante selecionada diretamente ao carrinho.

## Pedidos e estoque

Cada item do carrinho, item de pedido e baixa de estoque é feito contra a variante específica que o cliente escolheu — e não contra o pai. Isso significa:

- O estoque do `Large` pode esgotar enquanto o `Small` continua disponível, sem trabalho manual.
- Os pedidos registram o preço da variante no momento da compra, então aumentar o preço depois não altera pedidos passados.
- Relatórios e exportações mostram cada variante como um item separado, identificado pela etiqueta da variante.