Pular para o conteúdo principal
← Todos os guias

Dados estruturados

A marcação schema descreve uma página para a máquina num vocabulário que ela já conhece. O que isso compra é elegibilidade a um resultado mais rico — nunca uma posição e nunca uma garantia.

Elegibilidade, não ranqueamento

Marcação válida deixa uma página elegível a um resultado avançado. O Google escolhe essa palavra de propósito: incluir todas as propriedades obrigatórias qualifica a página para uma exibição enriquecida, não promete uma, e dados estruturados não são em si um fator de ranqueamento.

A distância entre elegível e exibido é maior do que quase todo mundo espera, e não é arbitrária. Se um recurso aparece depende da consulta, do aparelho, do país, de o recurso existir naquele idioma e do julgamento do próprio Google sobre se ele ajuda naquele contexto. A mesma página pode mostrar estrelas numa busca e não na seguinte.

JSON-LD é o formato a usar

As três sintaxes — JSON-LD, Microdata e RDFa — são igualmente aceitáveis para o Google, e JSON-LD é a que ele recomenda. A recomendação é prática, não técnica.

O JSON-LD vive numa única tag script em vez de ser costurado pela marcação como atributos nos elementos que descreve. Isso significa que ele sobrevive a uma refatoração de template, é lido num só lugar por quem o herdar, e um erro nele não perturba a página visível. Microdata acopla a descrição à apresentação, então todo redesenho arrisca perder propriedades em silêncio.

JSON-LD
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Robots.txt and sitemaps",
  "datePublished": "2026-06-14",
  "author": { "@type": "Organization", "name": "DigestSEO" }
}
</script>
  • Um bloco por entidade é mais claro do que um bloco gigante tentando descrever tudo o que há na página.
  • Gere-o a partir dos mesmos dados que renderizam a página, para que os dois não possam se separar.
  • Ele pode ser injetado por JavaScript, mas a página ainda precisa renderizar direito para a marcação ser vista.

A marcação precisa bater com a página

Descrever conteúdo que o visitante não consegue ver é violação de diretriz, não atalho. O Google nomeia os dois modos de falha explicitamente: páginas construídas como cascas vazias para carregar a marcação, e propriedades afirmando fatos que a página nunca exibe. Qualquer um dos dois pode custar o resultado avançado inteiro, e uma ação manual o remove no site todo, não só naquela página.

A versão mais comum disso não é deliberada. Um template emite uma nota agregada cujas avaliações foram removidas, ou um preço que um seletor de moeda muda no cliente, ou a data de um evento que já passou. Ninguém quis enganar; a marcação simplesmente sobreviveu ao conteúdo que descrevia. Por isso gerá-la a partir dos dados renderizados importa mais do que acertá-la uma vez.

SintomaCausa habitual
O recurso nunca apareceuFalta uma propriedade obrigatória, então a página não é elegível
Apareceu e depois parouO conteúdo mudou e a marcação não bate mais com ele
Marcação válida e mesmo assim nadaElegível mas não escolhida — consulta, idioma ou aparelho
Recurso perdido no site inteiroUma ação manual, informada no Search Console

Conectar entidades em vez de repeti-las

A maioria dos sites acaba descrevendo a mesma organização em toda página, com palavras um pouco diferentes a cada vez. O vocabulário tem resposta melhor que repetição: dê um @id à entidade, defina-a uma vez e referencie esse identificador em todo o resto.

Isso importa além da arrumação. Um buscador reconciliando três descrições sutilmente diferentes da sua empresa precisa decidir se são uma organização ou três; um identificador explícito tira dele o palpite. O mesmo vale para uma autora que escreve pelo site todo, ou para um produto referenciado tanto de uma listagem quanto de uma resenha.

sameAs é a outra metade. Ele aponta para os perfis e verbetes que já descrevem a entidade em outro lugar: um artigo da Wikipédia, uma conta oficial, um registro empresarial. Não é jogada de ranqueamento, é corroboração — exatamente o que um buscador precisa para ligar sua afirmação sobre você mesmo a algo que ele consiga checar.

Escolher quais tipos adicionar

O filtro útil é curto: existe um recurso de busca para este tipo, e a página consegue merecê-lo de verdade? Marcar um tipo sem resultado avançado por trás acrescenta manutenção e não muda nada nos resultados — a marcação fica válida, correta e inerte.

Declarar um tipo que a página não justifica é pior do que não adicionar a marcação, pois isso pode violar as diretrizes do recurso sem criar uma apresentação útil na pesquisa. Um artigo de guia não é um Product. O Google deixou de exibir resultados avançados de FAQ em 7 de maio de 2026 e removeu essa documentação em junho. É um lembrete de que recursos da Pesquisa podem ser retirados. Marque apenas o que a página realmente representa e consulte a galeria de recursos compatíveis antes de manter marcação para um recurso da Pesquisa.

  1. Identifique o que a página realmente é, nos termos do vocabulário.
  2. Verifique se existe um recurso de busca para esse tipo e o que ele exige.
  3. Emita cada propriedade obrigatória a partir dos dados que renderizam a página.
  4. Valide a sintaxe e depois confirme a elegibilidade no relatório de aprimoramentos.
  5. Recheque depois de mudanças de template — é aí que marcação e conteúdo se separam.

Teste no seu próprio site

Perguntas e respostas

Quais tipos valem a pena?

Os que têm um recurso de busca por trás que sua página consiga merecer de verdade. Marcar tipos sem resultado avançado associado acrescenta manutenção e não muda nada nos resultados.

Mais marcação ranqueia melhor?

Não. Dados estruturados não são fator de ranqueamento, e reivindicar tipos que a página não justifica coloca em risco a elegibilidade que você já tinha.

Minha marcação valida mas nenhum resultado avançado aparece. Por quê?

A validação prova que a sintaxe está certa, não que o recurso vai aparecer. Elegibilidade é o pré-requisito; a exibição depende da consulta, do aparelho, do país e do idioma, e do julgamento do Google sobre se ajuda ali.

JSON-LD, Microdata ou RDFa?

Os três são aceitáveis e o JSON-LD é o recomendado. Fica numa tag script em vez de costurado pela sua marcação, então sobrevive a mudanças de template e continua legível para quem cuidar dele depois.

Dados estruturados podem penalizar um site?

Marcação que descreve conteúdo que o visitante não vê viola as políticas de spam e pode render uma ação manual, que remove o recurso no site inteiro. A causa habitual não é engano e sim deriva: um template ainda emitindo uma nota ou um preço que a página não mostra mais.