Quando alguém procura um produto no Google, a página da sua loja compete com dezenas de outras que dizem quase a mesma coisa. O que muda a leitura do buscador é a clareza dos dados: preço, disponibilidade, avaliações, frete e devolução. Os dados estruturados em formato JSON-LD (JavaScript Object Notation for Linked Data) entregam essas informações em um bloco legível por máquina, sem depender de interpretação do layout.
Este guia mostra, passo a passo, como marcar Product, Offer e Review do jeito que a documentação do Google pede. Você vai ver quais propriedades são obrigatórias, como escrever preço e moeda, onde ficam avaliações, frete e devolução, como validar e quais erros mais derrubam a elegibilidade a resultados enriquecidos.
As três experiências do Google com dados de produto
A documentação de dados estruturados de Product separa o que o Google pode exibir em três grupos. Entender a diferença evita marcar a página errada com o tipo errado.
| Experiência | Para que serve | Quando usar |
|---|---|---|
| Snippets de produto | Mostrar nota, preço e disponibilidade em páginas sobre um produto | Páginas em que o usuário não compra direto, como análises editoriais e comparativos |
| Listagens de comerciante | Exibir produto com preço, frete, devolução e mais detalhes | Páginas de produto em que o cliente pode comprar da sua loja |
| Variantes | Agrupar tamanhos, cores e outras opções do mesmo produto | Produtos com variações, em ambos os casos acima |
Uma regra prática: se a página permite comprar, trate-a como listagem de comerciante. A documentação informa que atender às propriedades obrigatórias de listagens também torna a página elegível a snippets. E vale lembrar que o markup na página, combinado com o feed no Merchant Center, aumenta a chance de elegibilidade, já que os dois se complementam.
Para visualizar a diferença, a documentação do Google traz ilustrações de cada formato. À esquerda, o snippet de produto, com nota, número de avaliações, preço e estoque logo abaixo do resultado; ao centro, o carrossel de produtos populares; à direita, o painel de informações do Shopping, que reúne ofertas de várias lojas com preço e frete. As duas últimas são exemplos de listagens de comerciante. Os rótulos das ilustrações estão em inglês, como no original.
Passo 1: as propriedades mínimas de Product e Offer
Para listagens de comerciante, a página oficial exige, em Product, name, image e offers. Em Offer, são obrigatórios price (número maior que zero) e priceCurrency, com a moeda em código ISO 4217, como BRL. Note que o tipo precisa ser Offer, não AggregateOffer, porque o comerciante deve ser o vendedor.
| Tipo | Obrigatórias | Recomendadas |
|---|---|---|
| Product (listagem) | name, image, offers | aggregateRating, brand, description, color, category, gtin, review |
| Offer (listagem) | price, priceCurrency | availability, itemCondition, url, shippingDetails, hasMerchantReturnPolicy, priceValidUntil |
| Product (snippet) | name e pelo menos um entre review, aggregateRating ou offers | Os demais campos acima, conforme o caso |
| Offer (snippet) | price | availability, priceCurrency, priceValidUntil |
Para o código de barras, use a propriedade gtin com a variação certa (gtin8, gtin12, gtin13 ou gtin14), só com dígitos. Ele ajuda o Google a reconhecer o produto, e o post sobre a atualização dos dados estruturados com o gtin12 traz o contexto da mudança.
O diagrama abaixo mostra como esses tipos se encaixam em uma página de produto que vende: o Product é o tronco, o Offer guarda o preço e as condições de compra, e as avaliações ficam penduradas no próprio Product.
Como Product, Offer e Review se encaixam
Estrutura de uma página de produto elegível a listagem de comerciante.
name image offers. Recomendadas: brand gtin descriptionprice e priceCurrency (BRL). Recomendadas: availability itemCondition urlshippingDetails e hasMerchantReturnPolicyaggregateRating (nota média e total) e review (avaliações individuais)ProductGroup agrupa os tamanhos e cores com hasVariant. Cada variante é um Product com seu próprio Offer, sku ou gtin.Passo 2: como escrever preço, moeda e disponibilidade
A maior parte dos erros de markup nasce no formato do valor, não no conceito. O vocabulário do schema.org para Offer define as regras de escrita. Veja as mais importantes para o varejo brasileiro:
- price: apenas dígitos de 0 a 9 e ponto como separador decimal. Escreva 399.90, nunca “R$ 399,90”.
- priceCurrency: código ISO 4217, como BRL. O símbolo R$ não vale.
- availability: um único valor, como InStock, OutOfStock, PreOrder ou BackOrder, com ou sem o prefixo da URL do schema.org.
- priceValidUntil: data no futuro, em formato ISO 8601. A documentação de snippets avisa que uma data no passado pode impedir a exibição.
- Preço riscado: use UnitPriceSpecification com priceType StrikethroughPrice e sempre inclua o preço atual junto.
Um detalhe de conta: se offers.price e priceSpecification coexistirem, vale offers.price. Por isso, evite duplicar o preço em dois lugares com valores diferentes. Um exemplo simples: produto de R$ 399,90 com desconto de 10%. O preço atual é 399,90 × 0,90 = 359,91. O markup deve trazer price 359.91 e, se quiser mostrar o preço anterior, o riscado de 399.90 na estrutura própria.
Exemplo completo de JSON-LD para produto
O bloco abaixo reúne Product, Offer, avaliações, frete e devolução. Ele é ilustrativo: troque cada valor pelos dados reais da sua página e inclua apenas avaliações que existam e estejam visíveis para o usuário. O exemplo segue as propriedades das documentações citadas neste guia e o formato do schema.org.
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Tênis de corrida Veloz 2",
"image": [
"https://www.exemplo.com.br/img/veloz2-1x1.jpg",
"https://www.exemplo.com.br/img/veloz2-4x3.jpg",
"https://www.exemplo.com.br/img/veloz2-16x9.jpg"
],
"description": "Tênis de corrida leve com amortecimento reativo.",
"sku": "VLZ2-42-AZ",
"gtin13": "7891234567895",
"brand": { "@type": "Brand", "name": "Marca Exemplo" },
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": 4.6,
"bestRating": 5,
"reviewCount": 128
},
"review": [{
"@type": "Review",
"author": { "@type": "Person", "name": "Nome do cliente" },
"datePublished": "2026-10-02",
"reviewRating": { "@type": "Rating", "ratingValue": 5, "bestRating": 5 },
"reviewBody": "Texto real da avaliação, visível na página."
}],
"offers": {
"@type": "Offer",
"url": "https://www.exemplo.com.br/tenis-veloz-2?tam=42&cor=azul",
"price": 399.90,
"priceCurrency": "BRL",
"availability": "https://schema.org/InStock",
"itemCondition": "https://schema.org/NewCondition",
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingRate": { "@type": "MonetaryAmount", "value": 19.90, "currency": "BRL" },
"shippingDestination": { "@type": "DefinedRegion", "addressCountry": "BR" }
},
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"applicableCountry": "BR",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 7,
"returnFees": "https://schema.org/FreeReturn"
}
}
}
</script>
Dois lembretes sobre o exemplo. Primeiro, a documentação recomenda deixar frete e devolução no nível da organização, e usar o nível da oferta só para sobrescrever; o exemplo traz ambos na oferta para facilitar a leitura. Segundo, se existir configuração de frete ou devolução no Merchant Center ou no Search Console, ela tem precedência sobre o markup de produto, conforme as páginas oficiais de política de devolução e de política de frete.

Passo 3: Review e AggregateRating sem violar as regras
Nota e avaliações são o elemento que mais chama atenção no resultado, e também o mais vigiado. A documentação de review snippets pede, para Review, author (com nome válido), reviewRating.ratingValue e itemReviewed, este último dispensado quando a avaliação está aninhada em Product. Para AggregateRating, são necessários ratingValue e pelo menos um entre ratingCount e reviewCount.
- A escala padrão é de 1 a 5, com ponto decimal (4.4, não 4,4).
- As avaliações marcadas precisam estar visíveis na página.
- Não é permitido agregar avaliações de outros sites.
- As notas devem vir de usuários, não de editores que criam ou compilam notas.
- Avaliações falsas ou incentivadas sem divulgação são proibidas e podem gerar ação manual.
- Para LocalBusiness e Organization, avaliações controladas pela própria entidade, inclusive por widget de terceiros, tornam a página inelegível a estrelas.
A última regra trata de empresas, e não de produtos. Se a sua loja usa um widget próprio de avaliações em páginas de Product, a documentação lida não diz com todas as letras que a restrição se aplica igual; trate como risco e teste. Para o contexto das regras sobre notas incentivadas, veja o post sobre reviews falsas no schema de avaliações.
Passo 4: variantes, frete e devolução
Produtos com tamanho ou cor usam ProductGroup, conforme a documentação de variantes. O grupo exige name, e cada variante precisa de sku ou gtin único, ligado ao grupo por inProductGroupWithID ou isVariantOf. Cada variante deve ter URL própria, com imagem, preço e disponibilidade corretos. A propriedade variesBy descreve o que varia (cor, tamanho, material e outros).
Em devolução, a opção mais simples exige applicableCountry e returnPolicyCategory, com merchantReturnDays quando a janela é finita. Em frete, o nível da oferta usa OfferShippingDetails, com valor, destino e prazo. O ponto de atenção é a consistência: o que está no markup precisa bater com o que a página mostra e com o que a loja pratica.
Passo 5: onde implantar e como validar
Prefira que o markup de Product esteja no HTML inicial da página. A documentação de listagens avisa que o markup gerado por JavaScript pode ser rastreado com menos frequência e confiabilidade. Em plataformas como a Shopify, o filtro structured_data do Liquid gera Product, ou ProductGroup quando há variantes, com nome, imagem, descrição, marca e oferta, de acordo com a documentação para desenvolvedores. O exemplo oficial não traz avaliações, então verifique no tema real o que é gerado e o que vem de apps. Para as particularidades de cada plataforma, veja os guias de SEO para Shopify, VTEX e WooCommerce.
- Rode a página no teste de resultados multimídia do Google e na Inspeção de URL do Search Console, que a documentação de políticas gerais recomenda.
- Compare, campo a campo, o preço e a disponibilidade do markup com o que aparece na tela.
- Confira se há mais de um bloco Product na mesma página (tema, plugin e app de avaliações).
- Acompanhe os relatórios de rich results no Search Console depois de publicar.
- Repita o teste sempre que mudar o tema, o plugin de SEO ou o app de avaliações.
Um alerta que a própria documentação faz: markup válido não garante exibição. E, para a busca com IA, o Google diz que não há requisitos adicionais nem schema especial para aparecer em AI Overviews ou no Modo IA, de acordo com a página sobre recursos de IA na Busca. O markup continua útil porque deixa os dados consistentes, mas não é um atalho.
Erros comuns em dados estruturados de produto
A tabela de cada grupo mostra o erro, por que ele distorce o resultado e como corrigir. As regras vêm da documentação do Google e do Merchant Center; a frequência real em lojas brasileiras não foi medida.
Erros de valor e de formato
| Erro | Por que distorce | Como corrigir |
|---|---|---|
| Preço com vírgula ou “R$” | O valor deixa de ser lido como número e a oferta fica inválida | Usar 399.90 em price e BRL em priceCurrency |
| Preço do markup diferente do da página | Viola a regra de que o markup deve refletir o que o cliente vê e gera divergência com o Merchant Center | Gerar o preço do markup a partir da mesma fonte que renderiza a página |
| Availability sem sincronia com o estoque | Mostra produto disponível quando não está, o que prejudica a confiança | Atualizar o valor junto com o estoque e usar um único valor da lista oficial |
| priceValidUntil no passado | Pode impedir a exibição do snippet | Remover a propriedade ou renovar a data automaticamente |
Erros de estrutura e de conteúdo
| Erro | Por que distorce | Como corrigir |
|---|---|---|
| Página sem offers, só com name | A listagem exige offers; no snippet, offers sem avaliação gera aviso | Incluir Offer com price e priceCurrency |
| AggregateOffer em página de comerciante ou em variantes | A listagem exige Offer, e variantes não aceitam AggregateOffer | Usar Offer por variante dentro de ProductGroup |
| Marcação em conteúdo oculto | A política diz para não marcar o que o usuário não vê | Marcar apenas o que está visível |
| Markup duplicado por tema, plugin e app | Pode gerar dados conflitantes (a duplicidade em si não consta como regra da documentação lida) | Auditar e manter uma única fonte por tipo |
| Variantes sem sku ou gtin únicos | O Google não consegue distinguir as variantes | Definir sku ou gtin por variante e URL própria |
Erros de avaliações e de interpretação
| Erro | Por que distorce | Como corrigir |
|---|---|---|
| Review sem author | Author é obrigatório, com nome válido | Incluir nome da pessoa ou da organização |
| AggregateRating sem contagem ou com vírgula | Falta ratingCount ou reviewCount e o decimal fica inválido | Informar a contagem e usar ponto decimal |
| Marcar só algumas avaliações visíveis, ou agregar avaliações de outros sites | Contraria as diretrizes e pode levar a ação manual | Marcar todas as avaliações visíveis, só de usuários do seu site |
| Esperar que o schema garanta rich result ou citação por IA | Markup válido não garante exibição, e a IA não exige schema especial | Tratar o markup como base de consistência, não como atalho |
Checklist de dados estruturados de produto
- Product com name, image e offers em toda página de compra.
- Offer com price em formato numérico e priceCurrency em BRL.
- Availability com um único valor oficial, sincronizado com o estoque.
- gtin, marca e sku preenchidos quando existirem.
- Avaliações visíveis, de usuários, com author e contagem.
- Frete e devolução no nível da organização, com exceções na oferta.
- Variantes em ProductGroup, com URL própria.
- Teste no Rich Results Test e na Inspeção de URL após cada mudança.
- Uma única fonte de markup por página.
Perguntas frequentes
Qual a diferença entre snippet de produto e listagem de comerciante?
O snippet vale para páginas em que o usuário não compra direto, como análises. A listagem de comerciante vale para páginas de compra e exige Product com name, image e offers, e Offer com price e priceCurrency.
Como escrever o preço no JSON-LD?
Apenas com dígitos e ponto decimal, como 399.90, sem R$ e sem vírgula. A moeda vai em priceCurrency, com o código BRL.
Preciso de avaliações para ter dados estruturados de produto?
Não para listagens de comerciante. Para snippets de produto, é preciso pelo menos um entre review, aggregateRating ou offers. Se houver avaliações, elas precisam estar visíveis na página.
Posso marcar avaliações de outros sites na minha página?
Não. A documentação proíbe agregar avaliações de outros sites e exige que as notas venham de usuários, não de editores.
Dados estruturados ajudam a aparecer em respostas de IA?
O Google diz que não há requisitos adicionais nem schema especial para os recursos de IA. O markup mantém os dados consistentes, mas não é um atalho.
Como testar se o markup está correto?
Use o teste de resultados multimídia do Google e a Inspeção de URL do Search Console, compare o markup com o que aparece na página e acompanhe os relatórios de rich results.
Frete e devolução ficam no produto ou na organização?
A documentação recomenda o nível da organização, e o nível da oferta serve para sobrescrever. Configurações no Merchant Center ou no Search Console têm precedência sobre o markup.






