O que é marcação Schema? Dados estruturados com JSON-LD

Publicado:

17 min de leitura

Acar Diveroli
Autor: Acar Diveroli
Um bloco grosso de documento JSON-LD com chaves grandes, linhas de campos e uma faixa azul no topo, entre código esmaecido

Você pesquisa uma receita e um dos resultados mostra uma nota em estrelas e o tempo de preparo abaixo do título. Pesquisa um produto e vê o preço e "Em estoque" antes de clicar. Ou um plug-in do seu próprio site diz que adicionou o schema de produto, e o Search Console começa a mostrar um relatório de produtos do comerciante com avisos. Por trás dos três casos está a marcação Schema: informações rotuladas no código da página que os visitantes nunca veem.

Neste artigo explicamos o que é a marcação Schema, comparamos os três formatos e mostramos como adicionar um bloco JSON-LD, testado em dois validadores oficiais. Também vemos quais tipos de pesquisa aprimorada o Google ainda mostra em novembro de 2026, o que o Google diz sobre ranqueamento e respostas de IA, as regras contra spam e por que a marcação pode mudar de um país para outro.

O que é marcação Schema?

A marcação Schema (schema markup) é um código que descreve o que existe em uma página, como um produto, um artigo, um evento ou uma empresa, usando o vocabulário comum publicado em schema.org. Uma pessoa sabe que o número ao lado do botão é o preço; um programa só vê texto. A marcação diz isso de forma explícita: isto é um Product, ele tem um Offer, e o price dessa oferta é 24,90 em EUR.

O schema.org foi fundado por Google, Microsoft, Yahoo e Yandex e é desenvolvido como projeto aberto desde 2011, hoje por meio de um grupo comunitário do W3C. Em 17 de novembro de 2026, o vocabulário tinha 826 tipos e 1.540 propriedades. Tipos são categorias de coisas (Product, Article, LocalBusiness, Event), propriedades são os campos delas (name, author, openingHours), e algumas propriedades contêm outro tipo, assim como offers contém um Offer.

Como o vocabulário é compartilhado, um mesmo bloco de marcação pode ser lido por qualquer mecanismo de busca ou ferramenta que conheça o schema.org, não só pelo Google.

Marcação Schema e dados estruturados são a mesma coisa?

No SEO, na prática sim: os dois termos se referem aos mesmos dados rotulados em uma página da web. Dados estruturados são a ideia geral, informação guardada em campos com nome em vez de texto livre, do mesmo jeito que um formulário difere de uma carta. A marcação Schema é a forma de escrever dados estruturados com o vocabulário do schema.org, e é isso que o Google chama de "dados estruturados".

Dois outros usos da palavra confundem. O esquema de um banco de dados descreve as tabelas desse banco, e o JSON Schema é um padrão para verificar a estrutura de documentos JSON. Nenhum dos dois afeta os resultados de pesquisa.

JSON-LD, microdados ou RDFa: qual formato usar?

Use JSON-LD, a não ser que a sua plataforma já gere corretamente um dos outros dois. O Google aceita os três e os considera igualmente bons quando válidos, mas a introdução aos dados estruturados dele recomenda o JSON-LD como o mais fácil de implementar e de manter em grande escala.

FormatoOnde ficaPonto forteCuidado com
JSON-LDUm bloco <script>, separado do texto visívelFácil de gerar, ler e aninharPrecisa acompanhar a página
MicrodadosAtributos itemscope e itemprop no HTML visívelFica no próprio texto que as pessoas veemMudanças no template podem quebrá-lo
RDFaAtributos typeof e property no HTML visívelTambém atende vocabulários além do schema.orgTão frágil quanto os microdados

JSON-LD é JSON para dados vinculados (linked data), uma recomendação do W3C desde 2014 (versão 1.1 desde julho de 2020): JSON comum com algumas chaves reservadas que começam com @. O template de uma loja pode gerá-lo a partir do mesmo registro de produto que preenche a página. O Google também lê o JSON-LD que o JavaScript adiciona depois do carregamento, mas avisa que, para produtos, isso pode deixar os rastreamentos do Google Shopping menos frequentes e menos confiáveis.

Como a marcação Schema funciona, passo a passo?

Você escolhe um tipo, preenche as propriedades que o Google pede, coloca o bloco na página, testa e acompanha no Search Console.

  1. Escolha o tipo que corresponde à página. Uma página de produto é um Product, um post de blog é um Article, a página de uma filial é um LocalBusiness. A galeria de pesquisa do Google lista os recursos aceitos; use o tipo mais específico que servir.
  2. Consulte as propriedades obrigatórias e recomendadas no guia do Google para aquele recurso. O schema.org lista muito mais propriedades do que o Google usa, e o Google diz que é a documentação dele que define o comportamento da Pesquisa Google. Se faltar uma propriedade obrigatória, o item deixa de ser qualificado.
  3. Escreva o bloco JSON-LD na página, no <head> ou no <body>. Em um CMS, procure primeiro uma configuração nativa ou um plug-in, e preencha os valores com os mesmos dados que montam a página.
  4. Valide com o Schema Markup Validator e o Teste de pesquisa aprimorada (mostrado abaixo).
  5. Publique e depois inspecione um URL ativo com a ferramenta de inspeção de URL do Search Console para confirmar que o Google encontrou a marcação.
  6. Acompanhe os relatórios. Os relatórios de pesquisa aprimorada ficam em Melhorias no Search Console, e os de snippets de produto e produtos do comerciante, em Compras. Um template quebrado aparece como um salto nos itens inválidos.

Como é um exemplo de JSON-LD?

Este é um bloco completo para uma página de produto. A loja e o produto são inventados; example.com é um domínio reservado para documentação.

html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Example Steel Bottle 750 ml",
  "image": "https://example.com/img/steel-bottle-750.jpg",
  "description": "Double-walled steel water bottle, 750 ml.",
  "sku": "SB-750",
  "brand": { "@type": "Brand", "name": "Example Outdoor" },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/steel-bottle-750",
    "price": 24.90,
    "priceCurrency": "EUR",
    "availability": "https://schema.org/InStock"
  }
}
</script>
  • @context indica o vocabulário, e @type diz do que trata a página.
  • name, image e description repetem o que a página mostra.
  • offers contém um Offer: price é um número simples com ponto como separador decimal, e priceCurrency é o código ISO 4217 de três letras, não um símbolo.
  • availability recebe um valor do schema.org como InStock, OutOfStock ou PreOrder.

O bloco fica na página do próprio produto, e cada valor dele também deve estar visível ali para quem compra.

Como testar a marcação Schema?

Teste com duas ferramentas, porque elas respondem a perguntas diferentes: o Schema Markup Validator verifica a marcação em relação ao vocabulário do schema.org, e o Teste de pesquisa aprimorada do Google verifica se ela se qualifica para a pesquisa aprimorada do Google. Em 17 de novembro de 2026, colamos o exemplo acima no campo de código de cada uma.

O Schema Markup Validator, mantido pelo schema.org, encontrou um Product com 0 erros e 0 avisos. Ele substituiu em 2021 a antiga Structured Data Testing Tool do Google e aceita um URL ou um trecho de código.

O Teste de pesquisa aprimorada do Google informou 2 valid items detected (dois itens válidos detectados): o produto se qualificou tanto para snippets de produto quanto para produtos do comerciante. Cada um veio com dois problemas não críticos; citamos as mensagens como aparecem na interface em inglês:

  • Snippets de produto: Missing field "review" (optional) e Missing field "aggregateRating" (optional)
  • Produtos do comerciante: Missing field "hasMerchantReturnPolicy" (optional) e Missing field "shippingDetails" (optional)

Opcional quer dizer exatamente isso. Vale a pena adicionar os dados de devolução e frete se a loja os publica; os campos de avaliação devem ficar de fora, a não ser que a página mostre avaliações reais de clientes.

Depois quebramos o exemplo de propósito. Com o preço escrito como se escreve no Brasil, "price": 24,90, o validador informou No items detected (nenhum item detectado) e um erro de JSON-LD: Missing '}' or object member name. A vírgula encerra o valor antes da hora, e o bloco inteiro falha. Com um erro de digitação, "priceCurency", o produto foi encontrado, mas a propriedade foi sinalizada como não reconhecida para um Offer.

O que é pesquisa aprimorada e quais tipos o Google ainda mostra?

Pesquisa aprimorada é o nome que o Google dá aos resultados com detalhes extras tirados dos dados estruturados, os chamados rich results: preço e estoque, estrelas de avaliação, uma navegação estrutural ou as datas de um evento. A marcação qualifica a página, e o Google decide se exibe esses detalhes; ele não garante que apareçam, mesmo quando a marcação passa em todos os testes.

A lista muda, então confira antes de investir em um tipo. Em 17 de novembro de 2026, a galeria de pesquisa do Google listava 25 recursos, entre eles Artigo, Navegação estrutural, Evento, Anúncio de emprego, Empresa local, Organização, Produto, Receita, Snippet de avaliação e Vídeo. Vários recursos conhecidos saíram:

Pesquisa aprimoradaSituação em 17 nov. 2026Desde
HowToNão aparece mais, guia removidoSetembro de 2023
Perguntas frequentes (FAQ)Não aparece mais, guia removido7 de maio de 2026
Caixa de pesquisa de sitelinksNão aparece maisNovembro de 2024
Informações do curso, salário estimado, informações sobre o veículoNão aparecem maisSetembro de 2025
Navegação estruturalAparece só no computadorJaneiro de 2025
Produto, produtos do comerciante, snippet de avaliaçãoAparecemAinda compatíveis

A pesquisa aprimorada de perguntas frequentes tinha sido limitada em setembro de 2023 a sites governamentais e de saúde conhecidos; o Google a encerrou em maio de 2026. A marcação FAQPage continua sendo schema.org válido, mas não adiciona mais perguntas abaixo de um resultado do Google.

A marcação Schema ajuda no SEO e nas respostas de IA?

A marcação Schema ajuda ao qualificar a página para a pesquisa aprimorada; o Google não a apresenta como forma de ranquear melhor. Um resultado com preço ou nota informa mais antes do clique, e é daí que vem o ganho. As diretrizes do Google chegam a dizer que uma ação manual por dados estruturados remove a pesquisa aprimorada, mas não afeta o ranqueamento na pesquisa na web.

Para os recursos de IA, o guia do Google de otimização para a pesquisa com IA generativa, atualizado em julho de 2026, inclui o foco excessivo em dados estruturados entre os equívocos comuns: dados estruturados não são necessários para a pesquisa com IA generativa, e nenhuma marcação especial do schema.org é necessária, embora o guia recomende mantê-la para a pesquisa aprimorada. Ser citado em respostas de IA depende do conteúdo e do trabalho normal de SEO, que o nosso guia de otimização para mecanismos generativos (GEO) explica.

Quem mais lê o JSON-LD das suas páginas?

Qualquer programa que carregue a página pode lê-lo, porque o bloco é JSON simples dentro do HTML. Sites comparadores de preços, ferramentas de monitoramento de preços, ferramentas de feed de produtos e assistentes de IA que abrem uma página para um usuário recebem o mesmo bloco. Campos rotulados como price e availability são mais fáceis de ler com confiança do que um preço escondido em um layout que muda a cada reformulação do site.

É por isso que as ferramentas de monitoramento de preços procuram primeiro o JSON-LD e só recorrem ao HTML quando ele não existe, como mostra Como monitorar preços da concorrência no e-commerce. Para quem tem um site, a lição é a precisão: um preço errado na sua marcação chega a todas as ferramentas que a leem. Ser legível por máquina não quer dizer que o conteúdo possa ser reutilizado livremente; descrições, imagens e avaliações continuam sendo conteúdo do site.

O que conta como spam na marcação Schema?

Marcação que descreve algo que os visitantes não conseguem ver, ou algo que não é verdade, viola as diretrizes de dados estruturados do Google. As regras em que a maioria dos sites tropeça:

  • Marque só conteúdo visível. Uma nota, um preço ou uma pergunta que existe apenas no JSON-LD vai contra as regras.
  • Nada de avaliações falsas ou incentivadas sem aviso. O Google adicionou esta regra em julho de 2026: as avaliações precisam vir de experiência real, e as que são dadas em troca de dinheiro, descontos ou produtos grátis precisam de um aviso claro.
  • Nada de autoavaliação. Estrelas de avaliação para LocalBusiness e Organization são só para sites que avaliam outras empresas.
  • Nada de notas copiadas de outros sites, nem nota agregada que a página não mostre.
  • A marcação fica na página que ela descreve, com o tipo mais específico.

Quando o Google encontra uma violação, o relatório Ações manuais do Search Console mostra "Problema com dados estruturados". As páginas afetadas perdem a pesquisa aprimorada, mas o ranqueamento delas não é afetado por essa ação. Corrija a marcação e depois peça uma revisão no mesmo relatório.

Por que o JSON-LD de uma página pode mudar de um país para outro?

Uma loja que adapta os preços por país gera o JSON-LD com os mesmos dados da página visível, então um visitante na Alemanha pode receber "priceCurrency": "EUR" e um visitante no Reino Unido "GBP", com outro preço ou outra situação de estoque. Em geral, o site decide pelo endereço IP do visitante, então a marcação que uma ferramenta vê depende de onde sai a requisição.

Para verificar se a marcação de cada mercado corresponde à página visível desse mercado, é preciso carregar a página como um visitante dali. Com muitos produtos, isso entra no monitoramento de preços: compare o preço visível com o preço do JSON-LD em cada país e sinalize as páginas em que eles diferem.

Os Proxies residenciais enviam a requisição por uma conexão residencial no país e na cidade que você escolher, então o site entrega a página que um comprador local receberia. Use-os para conferir os seus próprios mercados, ou preços públicos respeitando os termos de cada site, não para contornar restrições regionais.

Onde a marcação Schema é usada?

  • Lojas virtuais: Product e Offer, além da política de devolução e dos dados de frete.
  • Sites de notícias e blogs: Article com autor e datas.
  • Empresas locais: LocalBusiness com endereço e horário de funcionamento.
  • Eventos, sites de vagas, receitas e vídeos, cada um com seus próprios tipos.
  • A página inicial: Organization com o nome oficial, o logotipo e os perfis em sameAs.

Erros comuns

  • Vírgula como separador decimal. "price": 24,90 quebra o bloco inteiro; escreva 24.90.
  • Símbolo de moeda no preço. Coloque o número em price e o código, como EUR ou BRL, em priceCurrency.
  • Nomes de propriedades com erro de digitação. O navegador ignora priceCurency em silêncio; só um validador aponta o erro.
  • Marcação que contradiz a página, como um preço em cache no JSON-LD mais antigo que o visível.
  • Adicionar avaliações para sumir com um aviso. Um campo opcional ausente não é erro; avaliações inventadas violam as regras.
  • Adicionar marcação para pesquisa aprimorada de FAQ ou HowTo. Nenhuma das duas aparece mais no Google.
  • Testar um URL e parar por aí. Templates quebram; acompanhe as contagens de itens inválidos no Search Console.

Guia de decisão

Sua situaçãoO que fazer
Site novo, ainda sem marcaçãoOrganization na página inicial, depois o tipo principal das páginas mais importantes
Loja virtualProduct e Offer em cada página de produto, gerados a partir do catálogo
Blog ou site de notíciasArticle com autor e datas
Um plug-in já adiciona marcaçãoTeste alguns URLs; remova blocos duplicados
O Teste de pesquisa aprimorada mostra só problemas não críticosAdicione os dados reais que você tem; deixe o resto
Você contava com a pesquisa aprimorada de FAQMantenha o FAQ para os leitores; o recurso não existe mais
Os preços mudam por paísConfira a página e a marcação de cada mercado a partir desse mercado

Perguntas frequentes

A marcação Schema ajuda no SEO?

Sim, indiretamente: ela ajuda os mecanismos de busca a entender a página e pode qualificá-la para a pesquisa aprimorada, mas o Google não a apresenta como forma de ranquear melhor. Meça o efeito em cliques, comparando páginas parecidas antes e depois no relatório de Performance do Search Console.

Qual é a diferença entre marcação Schema e tags Open Graph?

Tags Open Graph como og:image dizem às redes sociais e aos apps de mensagens como mostrar a prévia de um link; a marcação Schema descreve o que existe na página para mecanismos de busca e outros programas. A maioria dos sites usa as duas, e o Google registrou em março de 2026 que usa a marcação do schema.org e a tag og:image ao escolher a miniatura de uma página.

Como verificar se uma página tem marcação Schema?

Abra o código-fonte da página (Ctrl+U na maioria dos navegadores de computador) e procure application/ld+json; os microdados aparecem como atributos itemprop. O código-fonte mostra só o que o servidor enviou, então teste também o endereço no Teste de pesquisa aprimorada, que renderiza a página e encontra a marcação adicionada por JavaScript.

O que aconteceu com a Structured Data Testing Tool do Google?

O Google a transferiu para o schema.org em 2021, onde ela virou o Schema Markup Validator. Ele verifica a sintaxe do schema.org para qualquer tipo, mas não diz se a página se qualifica para a pesquisa aprimorada do Google; isso é o que o Teste de pesquisa aprimorada faz.

Preciso de um gerador de marcação Schema?

Não necessariamente. Um gerador é útil para uma única página, mas em um site real a marcação deve vir do CMS ou do template da página, para se atualizar quando o preço, a data ou o autor mudarem. Valide o resultado antes de publicar.

Preciso de marcação Schema para aparecer na Visão Geral Criada por IA?

Não. O guia do Google sobre a pesquisa com IA generativa diz que os recursos de IA dele, como a Visão Geral Criada por IA (AI Overviews), não precisam de nenhuma marcação especial do schema.org, e diz o mesmo sobre os arquivos llms.txt. Outros sistemas de IA que abrem a sua página recebem o JSON-LD junto com o resto do HTML.

Em resumo

A marcação Schema é a forma de escrever dados estruturados com o vocabulário do schema.org, e o melhor jeito de adicioná-la é um único bloco JSON-LD gerado com os mesmos dados da página visível. Escolha o tipo que o Google documenta, preencha as propriedades obrigatórias com honestidade, teste nos dois validadores e acompanhe as contagens de itens no Search Console. A marcação qualifica a página para a pesquisa aprimorada, não para um ranqueamento melhor, e os resultados de FAQ e HowTo saíram do Google. Se a sua marcação muda conforme o país do visitante, confira cada mercado a partir dele; a nossa página de produtos de proxy reúne as localizações para isso.