​

Product Recommendations

Quero “Você também pode gostar” na página de produto. Como implementar?

​

Contratos utilizados

• Data Contract — recommendations data key
• Product Contract — ProductSummary nos cards
• recommendations.list
• @corvex/theme-sdk — defineSectionData, storefront.recommendations.list
• Snippet: @corvex/snippets/product-card

​

API pública

const result = await storefront.recommendations.list({
  product: page.product,      // ResourceRef — produto da PDP
  first: 4,                   // o cliente repassa; não corta em 1–10
  intent: 'related',          // 'related' | 'complementary'
});

​

Fluxo de dados

PDP — page.product (contexto de URL)
        ↓
defineSectionData → storefront.recommendations.list({ product: page.product })
        ↓
data.recommendations.products.nodes
        ↓
Grid ProductCard

​

Schema

​

Renderização condicional

if (!data.recommendations?.meta?.count && !isEditing) {
  return null;
}

​

intent

​

Separação com Product Card

​

Checklist

• product: page.product — não settings.product
• meta.count === 0 → return null na vitrine
• Product Card snippet para UI
• Section só em enabledOn: ['product']
• corvex validate .

​

Veja também

• Product Card
• Featured Product — produto único + addItem
• recommendations.list query doc