técnico

JSON-LD passo a passo para uma página de artigo

Como montar, validar e manter dados estruturados de Article e BreadcrumbList coerentes com o texto, segundo as regras atuais da documentação do Google.

resposta curtaPara uma página de artigo, monte um JSON-LD do tipo Article com headline, author, datePublished e dateModified, e um BreadcrumbList com a trilha real. O Google não define propriedades obrigatórias para Article, apenas recomendadas, e exige que a marcação descreva o conteúdo visível. Valide com o Teste de Resultados Enriquecidos e mantenha as datas honestas.
Neste texto

Para quem é este passo a passo?

Este texto é para quem controla o template do site, ou trabalha com quem controla. Nível: intermediário. Pré-requisito: saber editar o HTML ou o cabeçalho do template. O resultado é um JSON-LD para páginas de artigo e um processo para mantê-lo coerente com o texto.

Um aviso inicial, que a documentação do Google repete: dados estruturados não são necessários para aparecer nos recursos de IA. O Google informa que não há schema.org especial para isso. A marcação serve para ajudar o Google a entender a página e para os resultados enriquecidos em que a documentação a prevê. Aplique pela clareza que ela dá, e não por expectativa de citação.

Passo 1: defina os dados em uma fonte única

Antes de escrever o JSON, liste os dados que aparecem na página: título, nome do autor, página do autor, data de publicação, data de atualização, imagem principal, trilha de navegação. Guarde-os em um lugar só (campos do CMS, front matter, planilha). Gere o texto visível e o JSON-LD a partir dessa mesma fonte.

Critério de sucesso: não existe um segundo lugar onde a data ou o autor sejam digitados à mão.

Passo 2: escolha as propriedades de Article

Segundo a documentação do Google, não há propriedades obrigatórias para Article; você inclui as que se aplicam ao conteúdo. As recomendadas são author (com name e url, ou sameAs), datePublished, dateModified, headline e image.

Regras que a documentação destaca:

  • Datas em formato ISO 8601, de preferência com fuso horário. Sem fuso, o Google usa o de Googlebot.
  • Inclua cada pessoa ou organização exibida como autora na página, e liste vários autores separadamente, sem juntar nomes no mesmo campo.
  • Em author.name, apenas o nome. Cargo, títulos e "publicado por" ficam em outras propriedades ou fora.
  • Use o tipo correto, Person ou Organization.

Passo 3: monte o JSON-LD

Exemplo com dados fictícios:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Como migrar um site para outro domínio",
  "image": "https://exemplo.com.br/img/migracao.jpg",
  "datePublished": "2026-10-14T09:00:00-03:00",
  "dateModified": "2026-10-14T09:00:00-03:00",
  "author": {
    "@type": "Person",
    "name": "Nome do Autor",
    "url": "https://exemplo.com.br/autor/"
  }
}
</script>

Verifique cada linha contra o que o leitor vê: o título é o mesmo da página, o autor aparece com o mesmo nome, as duas datas estão visíveis no texto, a imagem é a principal do artigo.

Passo 4: acrescente a trilha de navegação

Para o BreadcrumbList, a documentação define itemListElement como obrigatório, com ao menos dois itens. Cada ListItem tem position (1 é o início), name e item (a URL), e o último item pode omitir a URL, caso em que o Google usa a da própria página.

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Início", "item": "https://exemplo.com.br/" },
    { "@type": "ListItem", "position": 2, "name": "Artigos", "item": "https://exemplo.com.br/artigos/" },
    { "@type": "ListItem", "position": 3, "name": "Migração de domínio" }
  ]
}

A trilha deve ser a mesma que o leitor vê na página, com os mesmos nomes.

Passo 5: valide

  1. 01Cole a URL ou o código no Teste de Resultados Enriquecidos do Google e corrija os erros de sintaxe.
  2. 02Compare a marcação com o texto visível: título, autor e datas iguais.
  3. 03Publique e acompanhe os relatórios de dados estruturados no Search Console, por alguns dias.
  4. 04Se o relatório mostrar erro ou aviso, corrija no template e revalide.
  5. 05Registre a data da implementação e a versão do template.

Critério de sucesso: o teste não aponta erros críticos e a comparação manual não encontra divergência entre marcação e texto.

O que mudou com o FAQPage

Durante anos, o FAQPage foi uma das marcações mais copiadas. Segundo o histórico da documentação do Google, o resultado enriquecido de FAQ passou, em setembro de 2023, a ser exibido só para sites conhecidos e oficiais de governo e saúde, e deixou de aparecer no Google a partir de 7 de maio de 2026, com a documentação removida em junho de 2026. Se o seu template ainda gera FAQPage, a decisão é editorial: o formato de pergunta e resposta continua útil ao leitor, mas não espere resultado enriquecido no Google por causa da marcação. Veja o panorama em dados estruturados e Query Fan-Out.

Manutenção

  • Data de atualização honesta. Altere dateModified quando o conteúdo mudar de fato, e junto com a data visível.
  • Revisão junto com o texto. Mudou o autor, o título ou a imagem? A marcação muda no mesmo commit.
  • Auditoria trimestral. Amostre dez páginas e compare marcação e texto.
  • Documentação do Google. Ela é atualizada com frequência. Confira a data da página antes de seguir uma regra.

Erros comuns

  1. Copiar JSON-LD de outro site sem trocar autor, datas e URLs.
  2. Marcar o que não é visível, como avaliação, preço ou autor que não aparecem na página. A política do Google proíbe e pode impedir a exibição do resultado enriquecido.
  3. Juntar autores no mesmo campo. Liste cada um como objeto.
  4. Colocar cargo ou "publicado por" em author.name.
  5. Datas sem formato ISO 8601 ou com atualização falsa.
  6. Marcação para obter citação em IA. Não há schema especial para isso.
Article tem propriedades obrigatórias?

Segundo a documentação do Google, não. Você inclui as propriedades que se aplicam ao conteúdo. As recomendadas são author (com name e url), datePublished, dateModified, headline e image.

JSON-LD, Microdata ou RDFa?

O Google aceita os três e recomenda JSON-LD quando o site permite, por ser mais simples de implementar e manter em escala. Escolha o que a sua plataforma suporta e mantenha o padrão.

Posso colocar a marcação só no JSON-LD, sem texto visível?

Não. A política do Google pede que a marcação descreva o que o leitor vê. Dados que existem só na marcação podem violar as diretrizes e impedir a exibição do resultado enriquecido.

Preciso do BreadcrumbList?

Não é obrigatório para a página existir, mas ajuda o Google a entender a hierarquia e é usado em resultados quando elegível. A trilha precisa ser igual à da página.

Veja também a auditoria em dez verificações, o formato do bloco de resposta e a base de E-E-A-T.

Fontes

  1. Article structured data, Google Search Central (2026-09-08)
  2. Breadcrumb structured data, Google Search Central (2026-09-08)
  3. Introduction to structured data markup in Google Search, Google Search Central (2025-12-10)
  4. General structured data guidelines, Google Search Central (2026-07-10)
  5. FAQ (FAQPage) structured data, histórico de alterações, Google Search Central (2026-10-08)

Cubra as subconsultas

Liste as buscas que a IA faz por trás da pergunta e responda cada uma em um bloco próprio.