Dados estruturados no WordPress: como implementar passo a passo

Ricardo Nakamura

Escrito por

Tempo de leitura 9 min de leitura

Resumo rápido

  • No WordPress, há dois caminhos para os dados estruturados: o plugin de SEO (mais simples) ou um bloco JSON-LD inserido via código.
  • O Google recomenda o formato JSON-LD.
  • Os tipos mais úteis para a maioria dos sites são Organization, Article, BreadcrumbList, Product e LocalBusiness. O resultado avançado de FAQ deixou de aparecer na Busca em 7 de maio de 2026.
  • Teste com o Teste de pesquisa aprimorada (Rich Results Test) e o Schema Markup Validator, e monitore no Search Console.
  • Para busca com IA, o Google afirma que não existe marcação especial.

Antes de começar: o básico em 3 pontos

Dados estruturados são um formato padronizado para descrever o conteúdo de uma página (quem publicou, qual produto, qual preço, qual endereço) de um jeito que o Google consegue ler sem ambiguidade. Se quiser a explicação completa do conceito, veja o verbete de dados estruturados (Schema Markup) no glossário. Aqui o foco é colocar isso para funcionar no WordPress.

Três pontos da documentação do Google orientam todo o resto do guia:

  • JSON-LD é o formato recomendado. O Google aceita JSON-LD, Microdata e RDFa, mas recomenda JSON-LD por ser o mais fácil de implementar e manter em escala. Ele fica em uma tag <script> separada do texto visível.
  • Propriedades obrigatórias liberam a elegibilidade; recomendadas melhoram o resultado. O Google diz que é melhor fornecer menos propriedades, porém completas e corretas, do que preencher tudo com dados incompletos ou imprecisos.
  • Marcação não garante exibição. Mesmo com código válido, o Google decide se mostra o resultado avançado, dependendo da busca, do dispositivo e de outros fatores.

Referência certa: o Google orienta usar a documentação do Search Central, e não o schema.org, como definitiva para o comportamento na Busca. Um tipo pode existir no schema.org e não gerar nenhum recurso no Google.

Quais tipos de schema usar em um site WordPress

O tipo certo depende do que cada página realmente mostra. A tabela resume os mais comuns e o que a documentação do Google diz sobre eles em outubro de 2026:

Tipo Onde usar O que o Google faz com ele Observação
Organization Página inicial ou página “Sobre” Ajuda a entender e desambiguar a empresa; pode influenciar o logo exibido nos resultados e no painel de conhecimento Não há propriedades obrigatórias. Não precisa estar em todas as páginas. Logo com no mínimo 112×112 px
Article / BlogPosting Posts do blog e notícias Ajuda a mostrar título, imagens e datas de forma mais precisa Não há propriedades obrigatórias; author, datePublished e dateModified são recomendadas
BreadcrumbList Páginas internas com trilha de navegação Mostra a posição da página na hierarquia do site Desde janeiro de 2025, o recurso aparece só nos resultados para computador
Product Páginas de produto (WooCommerce ou catálogo) Pode exibir preço, disponibilidade e avaliações Para product snippets, exige name e pelo menos uma entre offers, review ou aggregateRating
LocalBusiness Empresas com endereço físico Detalhes como horário e endereço no painel de conhecimento Obrigatórias: name e address. Use o subtipo mais específico
FAQPage Páginas com perguntas e respostas Não gera mais resultado avançado na Busca Recurso descontinuado em 7 de maio de 2026; documentação removida em junho
HowTo Tutoriais passo a passo Não gera mais resultado avançado Documentação removida em setembro de 2023

O fim do FAQ como resultado avançado

O resultado de FAQ já vinha restrito desde 2023, quando o Google passou a exibi-lo apenas para sites governamentais e de saúde conhecidos e com autoridade. Em maio de 2026, o changelog do Search Central registrou a descontinuação: o recurso deixou de aparecer na Busca a partir de 7 de maio, e a página de documentação foi removida em junho. Na prática, adicionar FAQPage para ganhar o “acordeão” de perguntas na SERP não funciona mais.

A seção de perguntas frequentes não perdeu valor: continua útil para o leitor e pode disputar um featured snippet pelo texto em si. O que acabou foi a exibição especial ligada à marcação.

LocalBusiness para negócios com endereço

Para clínicas, escritórios e lojas, o LocalBusiness descreve endereço, telefone e horário. Use o subtipo mais específico do schema.org (como Dentist ou Restaurant). Ele complementa o Perfil da Empresa no Google, como explica o guia de SEO local.

Diagnóstico: o que o seu site já gera hoje

Antes de instalar qualquer coisa, descubra o que o site já marca. No WordPress, plugin de SEO, tema e plugins de loja ou avaliações podem gerar schema ao mesmo tempo, criando blocos duplicados ou contraditórios.

  1. Escolha páginas-modelo
    Separe uma URL de cada tipo: inicial, post, página institucional, categoria e produto. Como páginas do mesmo tipo usam o mesmo template, um erro tende a se repetir em todas.
  2. Rode o Schema Markup Validator em cada uma
    Ele lista todas as marcações schema.org encontradas, sem filtro de recursos do Google. É o jeito mais rápido de ver duplicidades.
  3. Rode o Teste de pesquisa aprimorada
    Ele mostra quais resultados avançados do Google a página pode gerar e aponta erros críticos e avisos.
  4. Identifique a origem de cada bloco
    Desative temporariamente plugins em um ambiente de homologação ou procure no código-fonte por application/ld+json e por atributos itemtype (Microdata, comum em temas antigos).
  5. Defina uma única fonte por tipo
    Escolha quem será responsável por cada marcação (normalmente o plugin de SEO) e desligue a opção equivalente no tema ou no outro plugin.

Se você está fazendo uma revisão geral do site, inclua essa etapa no checklist de SEO técnico, junto com rastreamento, indexação e performance.

Implementação via plugin de SEO

Para a maioria dos sites WordPress, o plugin de SEO resolve a maior parte do trabalho sem tocar em código: ele gera Organization ou Person no site todo, Article nos posts e BreadcrumbList nas páginas internas. A própria documentação do Google sugere que, em CMS como o WordPress, pode ser mais fácil usar um plugin integrado. Usaremos o Rank Math como exemplo, mas a lógica é parecida em outros plugins do mesmo tipo.

  1. Ative o módulo de schema
    No Rank Math, vá em Rank Math SEO > Dashboard > Modules e confirme que o módulo Schema (Structured Data) está ativo.
  2. Preencha os dados da entidade
    Nas configurações de SEO local do plugin (Local SEO), informe se o site representa uma pessoa ou organização, o nome, o logo e, se fizer sentido, endereço e telefone. Esses dados alimentam o Organization ou o LocalBusiness.
  3. Defina o tipo padrão por tipo de conteúdo
    Em Rank Math SEO > Titles and Meta, escolha o Schema Type padrão para posts (por exemplo, Article ou BlogPosting), para páginas e para cada tipo de post personalizado. Isso só define o padrão; cada post pode ser ajustado depois.
  4. Ajuste página a página quando necessário
    No editor, abra a aba Schema do plugin e use o Schema Generator para trocar o tipo ou preencher campos extras, como em uma página de serviço ou de curso.
  5. Configure o breadcrumb
    Se o plugin ou o tema oferecer breadcrumbs, ative a trilha e exiba-a nas páginas internas. A marcação deve refletir uma trilha visível para o usuário.
  6. Revise a loja, se houver
    Em sites com WooCommerce, confira se o schema de produto vem do plugin de SEO ou da própria loja, e mantenha apenas uma fonte.

Versão gratuita x paga: segundo a base de conhecimento do Rank Math, a versão gratuita cobre tipos como Article, Product, Local SEO e Breadcrumb. Schema personalizado e múltiplos schemas na mesma página ficam na versão PRO.

Um cuidado: plugins ainda oferecem tipos que o Google não usa mais para resultados avançados, como FAQ, HowTo e a caixa de pesquisa de sitelinks (removida em novembro de 2024).

Implementação manual com JSON-LD

O caminho manual serve quando o plugin não cobre o tipo necessário ou quando você quer controle total. A forma mais limpa é usar o gancho wp_head, que imprime conteúdo dentro do <head> do tema, e a função wp_json_encode(), que gera o JSON com as checagens do WordPress.

Exemplo de Organization exibido apenas na página inicial. Coloque o código em um plugin de snippets, em um mu-plugin ou no functions.php de um tema filho (nunca no tema pai, que é sobrescrito nas atualizações):

add_action( ‘wp_head’, function () {
  if ( ! is_front_page() ) { return; }
  $dados = array(
    ‘@context’ => ‘https://schema.org’,
    ‘@type’ => ‘Organization’,
    ‘name’ => ‘Exemplo Ltda’,
    ‘url’ => home_url( ‘/’ ),
    ‘logo’ => ‘https://www.exemplo.com.br/logo.png’,
    ‘sameAs’ => array( ‘https://www.linkedin.com/company/exemplo’ )
  );
  echo ‘<script type=”application/ld+json”>’ . wp_json_encode( $dados ) . ‘</script>’;
} );

Boas práticas no código manual

  • Puxe os dados do WordPress, não digite à mão. Em posts, use funções como get_the_title() e get_the_date(). Assim, a marcação acompanha o conteúdo visível e não fica desatualizada.
  • Use condicionais. is_front_page(), is_singular( 'post' ) e similares garantem que cada tipo apareça só nas páginas certas.
  • Evite conflito com o plugin. Se o plugin de SEO já gera um tipo, desative-o lá antes de criar o seu, ou use o filtro do próprio plugin para complementar o grafo.
  • Google Tag Manager só com cautela. O Google aceita JSON-LD gerado por GTM, mas alerta que, para produtos, marcação dinâmica pode tornar os rastreamentos do Shopping menos frequentes e confiáveis. Se o site depende muito de JavaScript, vale revisar o guia de JavaScript SEO.

Ao mexer no tema, aproveite para revisar também a performance com o guia de Core Web Vitals no WordPress.

Como testar e monitorar

O Google recomenda começar pelo Teste de pesquisa aprimorada e usar o Schema Markup Validator para validação genérica. As duas ferramentas têm papéis diferentes:

Ferramenta Para que serve Quando usar
Teste de pesquisa aprimorada (Rich Results Test) Mostra quais resultados avançados do Google a página pode gerar, com erros críticos e avisos Antes de publicar e sempre que mudar o template
Schema Markup Validator Valida qualquer marcação schema.org, sem avisos específicos do Google Para ver tudo o que a página declara e achar duplicidades
Inspeção de URL (Search Console) Mostra como o Google vê a página publicada e quais dados estruturados detectou Logo após publicar algumas páginas
Relatórios de resultados avançados (Search Console) Itens válidos e inválidos por tipo, ao longo do tempo, em “Melhorias” (e “Shopping” para produtos) Monitoramento contínuo
Dados estruturados não analisáveis (Search Console) Erros de sintaxe graves, como JSON inválido ou vírgula faltando Aparece só se o Google encontrar esse tipo de erro

O fluxo sugerido pela documentação é: validar no teste, publicar algumas páginas, conferir na Inspeção de URL e, se estiver tudo certo, pedir o novo rastreamento. Os relatórios mostram uma amostra e contam itens, não páginas. Depois de corrigir um erro, use o botão “Validar correção”. Para entender a lógica de validação e os outros relatórios da ferramenta, veja o guia completo do Google Search Console.

Atenção ao acesso: as diretrizes do Google pedem para não bloquear páginas com dados estruturados por robots.txt, noindex ou login. Se a página não é rastreada ou indexada, a marcação não tem efeito. Se o relatório de páginas mostra problemas, comece pelo guia de erros de indexação no Search Console.

Erros comuns e como corrigir

A maioria dos problemas vem de templates, plugins sobrepostos ou dados que não batem com a página:

Erro Sintoma Como corrigir
Marcação duplicada Dois Organization, dois Product ou Article repetido no validador Escolher uma fonte por tipo e desativar a opção no tema ou no outro plugin
Conteúdo invisível marcado Avaliações, preços ou perguntas que existem só no JSON-LD Marcar apenas o que o leitor vê na página, como exigem as diretrizes
Tipo errado para a página Product em página de serviço, Recipe em tutorial Usar o tipo que representa de fato o conteúdo principal
JSON quebrado Erro “JSON inválido” no relatório de dados não analisáveis Corrigir o template; gerar o JSON com wp_json_encode() em vez de concatenar texto
Propriedade obrigatória ausente Item inválido no relatório de resultados avançados Preencher o campo no plugin ou no código; conferir na documentação do recurso
Imagem inacessível Logo ou imagem do artigo não exibidos Garantir que a URL da imagem pode ser rastreada e indexada

No Article, informe o author com url para uma página de autor real, o que reforça a transparência ligada ao E-E-A-T.

Marcação enganosa ou avaliações falsas podem gerar ação manual. Segundo o Google, ela tira a elegibilidade para resultados avançados, sem afetar o ranqueamento na busca web.

Dados estruturados e busca com IA

Circulam muitas promessas sobre “schema para IA”. O que o Google documenta é mais contido:

  • Não existe schema especial para IA. O guia de otimização para recursos de IA generativa diz que dados estruturados não são obrigatórios para a busca generativa e que não há marcação schema.org específica a adicionar.
  • Continua valendo usar. O mesmo guia recomenda manter os dados estruturados como parte da estratégia de SEO, porque eles mantêm a elegibilidade para resultados avançados.
  • Coerência é requisito. Entre as boas práticas para os recursos de IA, o Google lista garantir que os dados estruturados correspondam ao texto visível da página.

Para outros assistentes, como ChatGPT e Perplexity, não há documentação pública equivalente que diga como (ou se) eles usam schema. O caminho mais seguro é o mesmo descrito no guia de GEO (Generative Engine Optimization): conteúdo claro, original e tecnicamente acessível, com a marcação servindo de apoio, e não de atalho.

Perguntas Frequentes

Preciso de plugin para ter dados estruturados no WordPress?

Não é obrigatório, mas é o caminho mais simples. Plugins de SEO geram Organization, Article e BreadcrumbList automaticamente. A alternativa é inserir JSON-LD com código, pelo gancho wp_head, o que dá mais controle e exige mais manutenção.

Ainda vale marcar FAQ com schema?

Para resultado avançado no Google, não: o recurso de FAQ deixou de aparecer na Busca em 7 de maio de 2026. A seção de perguntas frequentes continua útil para o leitor e pode disputar outros espaços pelo texto, mas a marcação FAQPage não traz mais exibição especial.

Dados estruturados melhoram o ranqueamento?

O Google apresenta os dados estruturados como forma de entender melhor a página e torná-la elegível para resultados avançados, não como fator de posição. O ganho costuma vir da aparência no resultado. Para medir, faça um teste de antes e depois em páginas estáveis.

Posso ter vários tipos de schema na mesma página?

Sim. O Google entende múltiplos itens, aninhados ou em blocos separados, desde que todos representem conteúdo visível. Um post pode ter Article e BreadcrumbList ao mesmo tempo, por exemplo. O que deve ser evitado é duplicar o mesmo tipo com dados conflitantes.

Fontes e referências

  1. Google Search Central. Introduction to structured data markup in Google Search.
  2. Google Search Central. General structured data guidelines.
  3. Google Search Central. Organization (Organization) structured data.
  4. Google Search Central (2026). Latest documentation updates.
  5. Google Search Central. Test your structured data.
  6. Google Search Central (2026). Optimizing your website for generative AI features on Google Search.
  7. Schema.org. LocalBusiness.
  8. Rank Math. Configuring Schema Markup in Rank Math for Rich Snippets.

Sobre o autor

Ricardo Nakamura

Ricardo Nakamura lidera o SEO Next+ da Oxigenweb, departamento dedicado a SEO e GEO (Generative Engine Optimization). Há mais de 5 anos conduz projetos digitais de ponta a ponta para marcas como JBS, Grupo Petrópolis, Caloi e Lufthansa City Center. Escreve sobre processos escaláveis de SEO, busca orientada por IA e como transformar otimização em resultado de negócio.

Ver perfil e todos os artigos de Ricardo →

Deixe seu comentário

dezoito − dez =