Pular para o conteúdo
PT · ₺
Acesso ao painel Comprar pacote
SEO técnico

Dados estruturados (Schema.org, JSON-LD): guia de implementação

6 minutos de leitura

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:

TipoEm qual página?O que oferece?
OrganizationPágina inicial / sobre nósNome da marca, logotipo, perfis oficiais; definição clara da organização
Article / BlogPostingArtigos de blog e notíciasEsclarecimento do título, autor e data
BreadcrumbListPáginas internasExibição do caminho (categoria > subcategoria) no lugar do endereço no resultado
Product + OfferPáginas de produtoResultados enriquecidos de produto com preço, estoque e avaliação
LocalBusinessPágina de negócio localEndereço, horários de funcionamento, telefone; apoio à visibilidade local
Event, Recipe, JobPostingPáginas de conteúdo específicoResultados 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

  1. 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.
  2. Associe cada modelo ao tipo adequado. Use a tabela acima; não adicione um tipo sobre o qual você tem dúvida.
  3. 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.
  4. Teste três ou cinco páginas de exemplo. Se não houver erros, amplie para o restante do site.
  5. 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

  1. 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.
  2. Use o tipo correto. Não coloque Product em uma página que não vende um produto, nem AggregateRating sem avaliações reais.
  3. 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.
  4. A página precisa ser rastreável. Marcação em página bloqueada pelo robots.txt ou com noindex não é utilizada.
  5. 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 Article duas 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.

Faltam cliques na sua palavra-chave?

O HitBot gera sessões reais que pesquisam a palavra-chave que pretende, encontram o seu site e clicam nele. O resultado acumula-se no Search Console como impressões e cliques.

Outros artigos