Corvex — Temas

Variante comprável de um Product. Fonte normativa: ProductVariant e ProductOption em @corvex/theme-sdk types (ApiVersion 2026-08).

Campos (`ProductVariant`)

Campo	Tipo	Nullable	Descrição
`id`	`string`	não	UUID da variante
`title`	`string`	não	Nome (ex.: “Azul / M”)
`sku`	`string`	sim	SKU
`availableForSale`	`boolean`	não	Disponível para compra
`price`	`Money`	não	Preço
`compareAtPrice`	`Money`	sim	Preço comparativo
`image`	`Image`	sim	Imagem da variante
`selectedOptions`	`Array<{ name: string; value: string }>`	não	Opções selecionadas

O mapper também preenche stock, trackInventory, isActive e position. Esses campos não fazem parte do contrato estável do tema. Use availableForSale para habilitar compra.

Product — campos para seleção

Campo	Tipo	Uso
`options`	`ProductOption[]`	`name` + `values[]` para UI
`variants`	`ProductVariant[]`	matching + availability

ProductOption: { name: string; values: string[] }.

Matching canônico

Formato real de opções na variante: array selectedOptions:

[
  { "name": "Cor", "value": "Preto" },
  { "name": "Tamanho", "value": "M" }
]

Variant correspondente quando todos os pares name/value da seleção completa coincidem com a variante:

function findVariant(product, selection) {
  return product.variants.find((variant) =>
    variant.selectedOptions.every(
      (opt) => selection[opt.name] === opt.value
    )
  ) ?? null;
}

selection é um mapa local Record<optionName, value> derivado da UI. Availability: somente variant.availableForSale. Para combinações parciais, verificar se existe alguma variante que estende a seleção atual (cookbook implementa isso). Implementação de referência: Variant Selector Cookbook.

Add to cart

import { useCorvexCart } from '@corvex/theme-sdk';

const { addItem } = useCorvexCart();

<button
  type="button"
  disabled={!variant?.availableForSale}
  onClick={() => addItem(product, 1, variant)}
>
  Comprar
</button>

MUST passar variant quando o produto tem múltiplas variantes selecionáveis. Ver Cart Contract.

Começar

Conceitos-chave

APIs e referências

Guias

Otimizar

Ferramentas

Marketplace

Storefront Components

Product Variant

Campos (`ProductVariant`)

Product — campos para seleção

Matching canônico

Add to cart

Tipos relacionados

​Campos (ProductVariant)

​Product — campos para seleção

​Matching canônico

​Add to cart

​Tipos relacionados

Campos (`ProductVariant`)

Product — campos para seleção

Matching canônico

Add to cart

Tipos relacionados