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.
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,
PersonouOrganization.
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
- 01Cole a URL ou o código no Teste de Resultados Enriquecidos do Google e corrija os erros de sintaxe.
- 02Compare a marcação com o texto visível: título, autor e datas iguais.
- 03Publique e acompanhe os relatórios de dados estruturados no Search Console, por alguns dias.
- 04Se o relatório mostrar erro ou aviso, corrija no template e revalide.
- 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
dateModifiedquando 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
- Copiar JSON-LD de outro site sem trocar autor, datas e URLs.
- 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.
- Juntar autores no mesmo campo. Liste cada um como objeto.
- Colocar cargo ou "publicado por" em
author.name. - Datas sem formato ISO 8601 ou com atualização falsa.
- 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
- Article structured data, Google Search Central (2026-09-08)
- Breadcrumb structured data, Google Search Central (2026-09-08)
- Introduction to structured data markup in Google Search, Google Search Central (2025-12-10)
- General structured data guidelines, Google Search Central (2026-07-10)
- 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.