Os dados estruturados (marcação schema.org) são uma forma de descrever explicitamente o conteúdo de uma página aos mecanismos de busca, usando um vocabulário padrão: isto é um artigo, aquilo é um produto, esta outra informação é o endereço de uma empresa. O Google usa os dados estruturados para compreender melhor a sua página e, quando for adequado, exibi-la nos resultados de busca de forma enriquecida (como breadcrumb, preço de produto ou estrelas de avaliação). Neste guia, explicamos passo a passo o que são o schema.org e o JSON-LD, quais tipos realmente funcionam, como adicioná-los e como testá-los.
O que são dados estruturados?
Ao ver o texto "R$ 199,90", uma pessoa entende que é um preço; um robô só consegue deduzir isso pelo contexto. Os dados estruturados eliminam essa dedução. O schema.org é o vocabulário comum desenvolvido em conjunto pelo Google, pela Microsoft e por outros mecanismos de busca; ele define centenas de tipos (Article, Product, Organization, Event, Recipe...) e as propriedades de cada tipo (name, price, author...).
Um fato importante: os dados estruturados não são um fator de ranqueamento direto. Eles não levam sua página para cima. Sua contribuição vem por dois caminhos: a melhor compreensão do conteúdo e a chance de obter uma aparência de resultado enriquecida. Um resultado mais chamativo pode aumentar a taxa de cliques, o que é um ganho indireto (sobre o aumento da taxa de cliques, veja nosso guia de CTR).
Por que JSON-LD?
Os dados estruturados podem ser escritos em três formatos: JSON-LD, Microdata e RDFa. O Google recomenda o JSON-LD. O motivo é simples:
o JSON-LD não fica misturado no meio do conteúdo da página; ele vive em um bloco separado <script type="application/ld+json">.
Assim, é gerenciado independentemente do design, é fácil de manter e tem menos risco de erro.
O bloco pode ser colocado na seção <head> ou no <body> da página.
Quais tipos funcionam?
Não é preciso adicionar todos os tipos a todas as páginas. O importante é escolher o tipo que corresponde ao que a página realmente é. A tabela a seguir resume as situações mais comuns:
| Tipo | Em qual página? | O que oferece? |
|---|---|---|
Organization | Página inicial / sobre nós | Nome da marca, logotipo, perfis oficiais; definição clara da organização |
Article / BlogPosting | Artigos de blog e notícias | Esclarecimento do título, autor e data |
BreadcrumbList | Páginas internas | Exibição do caminho (categoria > subcategoria) no lugar do endereço no resultado |
Product + Offer | Páginas de produto | Resultados enriquecidos de produto com preço, estoque e avaliação |
LocalBusiness | Página de negócio local | Endereço, horários de funcionamento, telefone; apoio à visibilidade local |
Event, Recipe, JobPosting | Páginas de conteúdo específico | Resultados enriquecidos especiais, como evento, receita ou vaga de emprego |
O suporte a resultados enriquecidos muda com o tempo. Em 2023, o Google limitou o resultado enriquecido de FAQ (perguntas frequentes) a sites governamentais e de saúde reconhecidos, e removeu totalmente o resultado enriquecido de HowTo. Adicionar essas marcações não causa dano, mas na maioria dos sites a aparência do resultado não muda. Consulte sempre a lista atualizada de tipos suportados na galeria do Google Search Central.
Se você tem um negócio local, a marcação LocalBusiness deve ser pensada junto com o Perfil da Empresa no Google e com a visibilidade no Maps; sobre o tema completo, veja nosso guia de SEO local.
Exemplo: marcação Article e Organization
Para um artigo de blog, um bloco básico de JSON-LD pode ser escrito assim. Altere os nomes dos campos e os valores de acordo com a sua página:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "O que é a tag canonical?",
"datePublished": "2026-11-06",
"dateModified": "2026-11-06",
"author": {
"@type": "Person",
"name": "Ana Silva"
},
"publisher": {
"@type": "Organization",
"name": "Exemplo Ltda.",
"logo": {
"@type": "ImageObject",
"url": "https://www.exemplo.com.br/logo.png"
}
},
"mainEntityOfPage": "https://www.exemplo.com.br/blog/canonical-etiketi-nedir"
}
</script>
Aqui, @context indica que o vocabulário é o schema.org, e @type indica o tipo do objeto.
Todos os campos devem ser coerentes com as informações visíveis na página: se a página não mostra o nome do autor, não coloque no bloco um autor inventado.
Na página inicial de um site institucional, da mesma forma, é possível informar com o tipo Organization o nome, o logotipo e os perfis oficiais em redes sociais (sameAs).
Para deixar visível na página a credibilidade do autor e da empresa, veja nosso guia de E-E-A-T.
A marcação BreadcrumbList, usada para o caminho de navegação (breadcrumb), é uma lista ordenada de itens:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Blog",
"item": "https://www.exemplo.com.br/blog"
},
{
"@type": "ListItem",
"position": 2,
"name": "SEO técnico"
}
]
}
</script>
Para o último item (a página em que o usuário está), o campo item é opcional. Cada item deve estar na mesma ordem e com os mesmos nomes do caminho visível na página.
Em páginas de produto, se o Product tiver offers (preço, moeda, situação do estoque) e avaliações reais de clientes, acrescenta-se o aggregateRating.
Aqui a regra é bem clara: preço e estoque devem ser iguais aos que aparecem na página, e a nota deve vir de avaliações reais e verificáveis de clientes.
Uma marcação que mostra um preço antigo engana o usuário e se transforma em alerta no Search Console.
Plano de implementação passo a passo
- Identifique os tipos de página. Quantos modelos diferentes existem no seu site? Página inicial, categoria, produto, artigo, contato etc. Para cada modelo, um único plano de marcação é suficiente.
- Associe cada modelo ao tipo adequado. Use a tabela acima; não adicione um tipo sobre o qual você tem dúvida.
- Gere a marcação dinamicamente no código do modelo. Preencha campos como título, data e preço a partir do banco de dados; valores fixos digitados à mão ficam desatualizados com o tempo.
- Teste três ou cinco páginas de exemplo. Se não houver erros, amplie para o restante do site.
- Acompanhe no Search Console. Depois da publicação, verifique a quantidade de páginas válidas e com erro, e priorize os alertas.
As regras básicas do Google
- A marcação deve ser coerente com o conteúdo visível. Acrescentar um preço, uma nota ou um comentário que não aparecem na página viola as políticas de spam do Google e traz risco de ação manual.
- Use o tipo correto. Não coloque
Productem uma página que não vende um produto, nemAggregateRatingsem avaliações reais. - Preencha as propriedades obrigatórias. Cada tipo de resultado enriquecido tem campos obrigatórios e recomendados; se um campo obrigatório falta, o resultado não é exibido.
- A página precisa ser rastreável. Marcação em página bloqueada pelo robots.txt ou com noindex não é utilizada.
- Dados estruturados não garantem nada. Ser válido não significa que o resultado enriquecido vai aparecer; o Google decide sozinho se mostra ou não.
O nível de detalhe da marcação é uma decisão sua, mas não é preciso ir a um nível excessivo. Para um artigo, título, autor, data de publicação e de atualização, imagem e informações do publicador costumam ser suficientes. Antes de adicionar uma propriedade nova, veja se ela tem correspondência na documentação do Google; se não tiver, acrescentá-la não terá efeito no resultado.
Teste e validação
Faça uma verificação em duas etapas, antes e depois da publicação:
- Teste de Resultados Enriquecidos do Google: ao colar um endereço ou código, você vê a quais resultados enriquecidos a página se qualifica, além de erros e avisos.
- Schema Markup Validator (validator.schema.org): valida a sintaxe geral do schema.org, que não é específica do Google.
- Search Console → Melhorias: acompanha a quantidade de páginas válidas, com aviso e com erro para os tipos encontrados no seu site. Depois de acrescentar um tipo novo, aguarde alguns dias para o relatório aparecer.
- Inspeção de URL: confirma que a marcação está presente na versão da página processada pelo Google; é especialmente útil para blocos adicionados com JavaScript.
Se você ainda não configurou o Search Console, siga nosso guia de início. Os dados estruturados fazem parte da verificação técnica de saúde do site; para os demais itens, use nossa checklist de SEO técnico.
Erros comuns
- Marcar informação que não aparece para o usuário. O que o usuário não consegue ver também não deve constar na marcação.
- Adicionar avaliações ou notas falsas. Marcar avaliações que não vieram de clientes reais, mas que foram escritas por você, é violação de política.
- Blocos duplicados pelo plugin. Se o tema e um plugin de SEO geram a mesma marcação
Articleduas vezes, ocorre conflito; mantenha apenas uma. - JSON inválido. Uma vírgula, aspas ou chave que faltam invalidam o bloco inteiro. Não publique sem passar pelo validador.
- Informação desatualizada. Se o preço, o estoque ou a data de um evento mudam e a marcação não é atualizada, o Search Console emite alerta e a confiança do usuário é abalada.
- Exagero desnecessário. Preencher a página com tipos que não geram resultado enriquecido é perda de tempo; comece pelos três ou cinco tipos de que o seu site realmente precisa.
Perguntas frequentes
Dados estruturados melhoram o meu ranqueamento?
Diretamente, não. Eles ajudam a compreender o conteúdo e aumentam a chance de obter um resultado enriquecido; isso pode influenciar indiretamente a taxa de cliques.
Qual plugin ou ferramenta devo usar?
O plugin de SEO do seu CMS gera automaticamente os tipos básicos e basta para a maioria dos sites. Para tipos específicos, adicione o JSON-LD manualmente ou por código de modelo, e sempre valide pelo validador.
Há problema em adicionar o JSON-LD com JavaScript?
O Google consegue processar JSON-LD adicionado por JavaScript, mas, sempre que possível, é mais confiável colocá-lo do lado do servidor, na primeira resposta HTML.
Cometi um erro. O resultado enriquecido desaparece imediatamente?
Uma marcação inválida ou contrária à política pode fazer o resultado enriquecido sumir. Corrija o erro e inicie a validação pelo Search Console; a reavaliação leva tempo.
Conclusão
Os dados estruturados não são um atalho que promete ganhos rápidos, e sim uma forma organizada de apresentar corretamente o seu conteúdo.
Use JSON-LD, marque somente a informação que realmente está na página, teste com os validadores e acompanhe regularmente no Search Console. Para começar, adicionar Organization à página inicial,
Article aos artigos, BreadcrumbList às páginas internas e Product aos produtos basta para a maioria dos sites.
O restante do seu tempo, dedique à qualidade do conteúdo e à velocidade.