Schema markup no WordPress: como conseguir rich results (2026)

Se você digitou "schema markup wordpress" numa busca, provavelmente já sabe que isso tem a ver com aparecer melhor no Google, mas a explicação técnica costuma vir cheia de jargão. Vamos direto ao ponto: schema markup (ou dados estruturados) é um jeito de descrever o conteúdo da sua página numa linguagem que máquinas entendem sem ambiguidade, para além do HTML visível que só humanos interpretam com contexto. Neste guia, mostramos o que são esses dados estruturados, quais tipos realmente valem o esforço no WordPress, como adicionar sem gambiarra e como testar se o código está correto antes de publicar.

O que são dados estruturados (e por que JSON-LD venceu os microdados)

Dados estruturados são um vocabulário compartilhado, mantido pelo projeto schema.org, que descreve "isto é um artigo, publicado nesta data, por este autor" ou "isto é uma pergunta, e esta é a resposta" de forma que buscadores e assistentes de IA processam automaticamente, sem precisar adivinhar pelo layout da página.

Existem duas formas técnicas de implementar isso: microdados, que misturam atributos itemprop direto nas tags HTML visíveis, e JSON-LD, um bloco de código independente, normalmente dentro de uma tag <script type="application/ld+json">, separado do HTML que o visitante vê. O Google recomenda JSON-LD há anos, e por um motivo prático: como o bloco fica isolado do markup visual, você pode gerar, testar e atualizar o schema sem correr o risco de quebrar o layout da página, e o código fica muito mais fácil de validar automaticamente. Um exemplo simples de Article em JSON-LD:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Título do seu post",
  "datePublished": "2026-07-18",
  "author": { "@type": "Person", "name": "Seu Nome" }
}
</script>

Note que aspas dentro de valores de texto (por exemplo, num título com citação) precisam ser escapadas corretamente como \", senão o JSON quebra e o schema inteiro é ignorado. É exatamente esse detalhe que costuma sair errado quando alguém monta o código à mão.

Quais tipos de schema importam de verdade no WordPress

O vocabulário do schema.org tem centenas de tipos, mas só um punhado costuma valer o esforço num blog ou site institucional em WordPress:

• Article / BlogPosting: identifica um post com título, autor e data. Ajuda o Google a mostrar a data de publicação nos resultados e dá aos assistentes de IA metadados confiáveis para citar a fonte.
• FAQPage: marca pares de pergunta e resposta, como os do fim deste artigo. Atenção à data dos tutoriais que você lê por aí: desde agosto de 2023 o Google exibe as perguntas expansíveis apenas para um grupo pequeno de sites governamentais e de saúde, e desligou o recurso para todo o resto. O tipo continua útil porque diz a um assistente de IA, sem rodeio, qual frase é a pergunta e qual é a resposta.
• HowTo: descreve uma sequência de passos, com duração total opcional no formato ISO 8601, por exemplo PT45M para 45 minutos. Passos numerados no resultado de busca não existem mais: o Google retirou esse rich result em 2023. Como estrutura legível por máquina para tutoriais e guias técnicos o tipo segue valendo, mas não conte com nenhum efeito visível na busca.
• BreadcrumbList: mostra a hierarquia de navegação (Início > Blog > Artigo) no lugar da URL crua no resultado de busca, deixando o link mais legível e confiável.
• Product: essencial para lojas, com preço, disponibilidade e avaliações, habilitando os resultados com estrelas e preço que aparecem em buscas de produto.

Os que ainda aparecem habilitam rich results diferentes: estrelas de avaliação com preço, a data correta ao lado de um artigo, breadcrumb no lugar da URL crua. O denominador comum é que todos aumentam o espaço visual do seu resultado na busca, o que historicamente melhora a taxa de cliques mesmo sem mudar de posição no ranking.

Qual tipo ainda rende algo visível em 2026

O círculo é menor do que a maioria dos tutoriais na internet admite. O Google fez faxina em 2023 e tirou dos resultados duas das marcações mais populares. Isso não as tornou inúteis, apenas mudou onde elas agem: nos buscadores com IA, no seu próprio llms.txt e em qualquer lugar onde um programa precise ler o seu texto em vez de olhar para ele.

Por que isso importa ainda mais na era da busca com IA

Ferramentas de busca com IA, como o resumo por IA do Google ou assistentes que navegam a web para responder perguntas, dependem de conseguir extrair fatos da sua página de forma confiável e rápida. Dados estruturados fazem exatamente esse trabalho: em vez de o modelo precisar interpretar o layout visual e adivinhar o que é o autor, a data ou a resposta de uma pergunta, o schema entrega isso pronto, num formato que a máquina já sabe ler. Esse é o núcleo do que se chama de AEO (answer engine optimization): página sem dados estruturados não fica invisível para IA, mas fica em desvantagem na hora de ser citada com precisão frente a páginas que já entregam o dado mastigado.

Ao lado do schema: llms.txt e blocos de resposta

O JSON-LD responde ao que significa um trecho específico. Duas peças vizinhas respondem a qual página importa afinal, e essa é a primeira pergunta que um buscador com IA faz.

llms.txt é um arquivo Markdown simples na raiz do seu domínio, acessível em seu-dominio.com.br/llms.txt. Ele lista os conteúdos que você prioriza para sistemas de IA, com título, link e meia frase sobre para que servem. Em vez de cavar entre menu, aviso de cookies e rodapé, um assistente lê um mapa curado; a versão mais extensa se chama llms-full.txt. A ressalva honesta: é uma proposta, não um padrão aprovado, e nenhum buscador garante que lê o arquivo. Em compensação o esforço é pequeno, porque não tem mais do que isto dentro:

# Site de exemplo

> Manutenção de WordPress feita em Hamburgo, especializada em temas de blocos rápidos.

## Principal
- [Serviços](/servicos/): o que construímos e o que não
- [Preços](/precos/): pacotes com preço fechado

## Opcional
- [llms-full.txt](/llms-full.txt)

Os blocos de resposta são a segunda peça: um resumo logo no começo, uma definição em uma frase, pares de pergunta e resposta, passos numerados. Eles existem para quem lê e, de quebra, produzem exatamente o formato de texto que um sistema de IA consegue aproveitar sem reconstruir o parágrafo antes. Se você os escreve no editor e deixa a marcação correspondente sair junto, some o trabalho dobrado que na prática derruba o schema feito à mão. No nosso caso esse trabalho é dividido como o diretório do WordPress exige: o tema Hafen cuida da apresentação, e o plugin companheiro Hafen Core gera o JSON-LD de artigos, autores, breadcrumbs e organização, além do llms.txt e dos blocos de resposta. O motivo é uma regra do diretório: uma função precisa sobreviver a uma troca de tema, então um tema só pode responder pela apresentação.

Formas honestas de adicionar schema no WordPress

Existem três caminhos legítimos, cada um com um custo diferente:

1. Plugin de SEO

Yoast SEO e RankMath geram Article e BreadcrumbList automaticamente a partir do conteúdo do post, e oferecem blocos de FAQ e HowTo no editor que já produzem o JSON-LD correspondente. É o caminho mais simples para quem já usa um desses plugins para outras tarefas de SEO, mas adiciona mais uma camada de plugin ao site, com o peso e a manutenção que isso implica.

2. Bloco de código manual

Para quem tem controle sobre o tema, é possível colar o JSON-LD direto no functions.php ou num bloco de código HTML no editor, próximo ao conteúdo visível que ele descreve. Funciona bem para uma página isolada, mas escala mal: cada post exige edição manual, e um erro de digitação no JSON invalida o schema inteiro sem aviso visível na tela.

3. Tema com plugin companheiro

Alguns temas de bloco mais recentes vêm com um plugin companheiro que gera Article, FAQPage, BreadcrumbList e Organization automaticamente a partir do conteúdo do Site Editor, sem plugin de SEO e sem edição manual de JSON. É assim no nosso Hafen: o tema cuida da apresentação e o JSON-LD sai do plugin gratuito Hafen Core. A divisão é regra do diretório, porque uma função precisa sobreviver a uma troca de tema; quem instala só o tema não recebe JSON-LD. É o caminho mais direto quando você está escolhendo tema do zero, mas não ajuda quem já tem um tema definido e só precisa resolver o schema pontualmente.

Erros típicos que colocam o schema em risco

Schema mal aplicado não é só ineficaz, em alguns casos pode gerar penalidade manual do Google:

• Schema sem conteúdo visível correspondente: marcar um FAQPage com perguntas que não aparecem em lugar nenhum da página visível viola as diretrizes do Google e é o motivo mais comum de penalidade manual por dados estruturados enganosos. O schema deve sempre espelhar o que o visitante humano também consegue ler.
• Campos obrigatórios desatualizados: os requisitos de cada tipo mudam com o tempo. Um Article sem datePublished, ou um Product sem availability, costuma ser aceito pelo validador mas não gera o rich result completo.
• JSON malformado: uma vírgula sobrando ou uma aspa não escapada invalida o bloco inteiro, silenciosamente, sem quebrar a página visualmente. É por isso que testar antes de publicar não é opcional.
• Schema duplicado: plugin de SEO e tema gerando o mesmo tipo de schema ao mesmo tempo confunde o buscador sobre qual versão é a correta. Verifique se apenas uma fonte está emitindo cada tipo.

Como testar antes de publicar

Depois de adicionar o schema, sempre valide antes de considerar o trabalho pronto. A ferramenta oficial para isso é o Teste de Resultados Aprimorados do Google: cole a URL da página ou o código JSON-LD diretamente, e ele mostra quais tipos de rich result foram detectados, além de avisos sobre campos recomendados que estão faltando. Erros aparecem em vermelho e impedem o rich result; avisos em amarelo são recomendações que valem a pena resolver, mas não bloqueiam a exibição.

Vale reforçar: passar no teste não garante que o Google vai exibir o rich result. A validação confirma que o código está correto, mas a decisão de mostrar (ou não) o resultado enriquecido continua sendo do algoritmo do buscador, caso a caso.

Uma limitação faz parte do quadro: para FAQPage e HowTo o teste não mostra mais pré-visualização, já que o Google desligou esses resultados. Se a marcação é válida você ainda vê ali, e também no Schema Markup Validator, que valida contra o schema.org sem levar em conta o que o Google decide exibir. Para um erro de digitação puro, um validador de JSON comum responde ainda mais rápido.

A proposta do Hafen: schema no plugin, apresentação no tema

Como parte interessada nessa conversa, preferimos ser diretos em vez de vender demais. O tema Hafen cuida da apresentação, e o plugin companheiro gratuito Hafen Core gera Article, FAQPage, BreadcrumbList e Organization automaticamente a partir do que você já escreve no Site Editor do WordPress, sem plugin de SEO adicional e sem risco de JSON malformado por digitação manual, porque o código sai direto da estrutura do conteúdo, não de um campo de texto solto. Essa separação é regra do diretório: uma função precisa sobreviver a uma troca de tema, por isso não pode morar no tema, e quem instala só o tema não recebe JSON-LD. O tema está gratuito no diretório oficial de temas do WordPress: a versão 1.0.0 saiu em 4 de setembro de 2026 e traz 38 looks entre os quais você alterna sem refazer nada. O Hafen Core também é gratuito, está no diretório oficial de plugins e desde 4 de setembro de 2026 na versão 1.0.1. O que ele não tem são anos de rodagem em servidores alheios, e isso um tema veterano tem. Como ele é montado por dentro está em Hafen 1.0: um tema, 38 looks, zero arquivos de fonte. Se você já tem um tema definido e só precisa resolver o schema numa página específica, o gerador gratuito de schema resolve isso sem trocar de tema.

Conclusão

Schema markup no WordPress não é um truque de SEO, é uma tradução do seu conteúdo para uma linguagem que máquinas, buscadores e assistentes de IA entendem sem ambiguidade. O caminho certo depende do seu ponto de partida: um plugin de SEO resolve rápido para quem já usa um, um bloco de código manual funciona para casos pontuais, e um tema com plugin companheiro, como o Hafen com o Hafen Core, elimina o problema pela raiz para quem está montando o site do zero. Em qualquer caso, valide sempre com o Teste de Resultados Aprimorados do Google antes de considerar o trabalho concluído. Depois de resolver o schema, vale revisar também como deixar o WordPress mais rápido e, se você está repensando o construtor de páginas do site, nosso guia sobre alternativa ao Elementor.

Perguntas frequentes