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.
| Formato | Onde fica | Ponto forte | Cuidado com |
|---|---|---|---|
| JSON-LD | Um bloco <script>, separado do texto visível | Fácil de gerar, ler e aninhar | Precisa acompanhar a página |
| Microdados | Atributos itemscope e itemprop no HTML visível | Fica no próprio texto que as pessoas veem | Mudanças no template podem quebrá-lo |
| RDFa | Atributos typeof e property no HTML visível | Também atende vocabulários além do schema.org | Tã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.
- Escolha o tipo que corresponde à página. Uma página de produto é um
Product, um post de blog é umArticle, a página de uma filial é umLocalBusiness. A galeria de pesquisa do Google lista os recursos aceitos; use o tipo mais específico que servir. - 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.
- 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. - Valide com o Schema Markup Validator e o Teste de pesquisa aprimorada (mostrado abaixo).
- 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.
- 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.
<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>@contextindica o vocabulário, e@typediz do que trata a página.name,imageedescriptionrepetem o que a página mostra.offerscontém umOffer:priceé um número simples com ponto como separador decimal, epriceCurrencyé o código ISO 4217 de três letras, não um símbolo.availabilityrecebe um valor do schema.org comoInStock,OutOfStockouPreOrder.
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)eMissing field "aggregateRating" (optional) - Produtos do comerciante:
Missing field "hasMerchantReturnPolicy" (optional)eMissing 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 aprimorada | Situação em 17 nov. 2026 | Desde |
|---|---|---|
| HowTo | Não aparece mais, guia removido | Setembro de 2023 |
| Perguntas frequentes (FAQ) | Não aparece mais, guia removido | 7 de maio de 2026 |
| Caixa de pesquisa de sitelinks | Não aparece mais | Novembro de 2024 |
| Informações do curso, salário estimado, informações sobre o veículo | Não aparecem mais | Setembro de 2025 |
| Navegação estrutural | Aparece só no computador | Janeiro de 2025 |
| Produto, produtos do comerciante, snippet de avaliação | Aparecem | Ainda 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
LocalBusinesseOrganizationsã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:
ProducteOffer, além da política de devolução e dos dados de frete. - Sites de notícias e blogs:
Articlecom autor e datas. - Empresas locais:
LocalBusinesscom 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:
Organizationcom o nome oficial, o logotipo e os perfis emsameAs.
Erros comuns
- Vírgula como separador decimal.
"price": 24,90quebra o bloco inteiro; escreva24.90. - Símbolo de moeda no preço. Coloque o número em
pricee o código, comoEURouBRL, empriceCurrency. - Nomes de propriedades com erro de digitação. O navegador ignora
priceCurencyem 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ção | O que fazer |
|---|---|
| Site novo, ainda sem marcação | Organization na página inicial, depois o tipo principal das páginas mais importantes |
| Loja virtual | Product e Offer em cada página de produto, gerados a partir do catálogo |
| Blog ou site de notícias | Article com autor e datas |
| Um plug-in já adiciona marcação | Teste alguns URLs; remova blocos duplicados |
| O Teste de pesquisa aprimorada mostra só problemas não críticos | Adicione os dados reais que você tem; deixe o resto |
| Você contava com a pesquisa aprimorada de FAQ | Mantenha o FAQ para os leitores; o recurso não existe mais |
| Os preços mudam por país | Confira 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.




