Skip to main content
No SDK, storefront.collections é alias de storefront.categories. Use storefront.categories.list() / .get() / .getByHandle().
Coleção = categoria. URLs de vitrine são /collections/:handle, mas os métodos do SDK usam o namespace categories (com alias collections). Ver Erros comuns.

Campos (SDK)

Imagem — payload bruto vs SDK

A origem pode devolver image como string URL:
O SDK (mapCategorySummary), quando o backend manda image como string, grava:
id vira a própria URL. altText vira o título da categoria.

Renderizar no tema

Nunca use <img src={category.image} /> — image é objeto após o SDK, não string.

Mapeamento backend → SDK

Buscar lista

Com hook no editor:
Documentação completa: categories.list.

Buscar uma coleção

Setting no editor

O picker type: "collection" salva o UUID da categoria:
Lista manual (collection_list):
Na query de produtos, passe em collection ou category — o SDK envia categoryId ao backend. Deixe vazio para não filtrar por categoria.

Contexto de template collection

Em /collections/:handle, a plataforma injeta:
Ver Contexto de página.

Exemplo — grid na home

Section de referência: collection-list.

Tipos relacionados