`collection`


type	`collection`
Valor salvo	`string` — UUID da categoria

No backend, coleção é categoria. A URL da vitrine usa /collections/:handle. O campo não grava o handle.

Propriedades

O validador exige id e type. label é recomendado. default é opcional. O picker grava collection.id. storefront.products.list({ collection: settings.collection }) envia esse id como categoryId. Sem id, products.get e categories.get devolvem null quando o argumento é vazio.

Exemplo

{
  "id": "collection",
  "type": "collection",
  "label": "Coleção"
}

Runtime — filtrar produtos

const products = await storefront.products.list({
  first: settings.limit ?? 8,
  collection: settings.collection,
});