Schema markup quebrado no WordPress: como corrigir os erros

Tipo SEO Tecnico

Nome do erro Schema markup quebrado EN: Broken schema markup

Severidade Atenção

Descrição Schema markup quebrado no WordPress é quando os dados estruturados da página têm campos obrigatórios faltando, valores inválidos ou marcação duplicada, e o Google deixa de exibir os rich snippets. A causa mais comum é dois plugins gerando schema ao mesmo tempo ou um campo obrigatório (como autor ou data) ausente.

O que é o schema markup quebrado?

Schema markup, ou dados estruturados, é um trecho de código (em JSON-LD) que descreve o conteúdo da página para o Google, habilitando os resultados aprimorados como estrelas de avaliação, perguntas frequentes e dados de receita. Ele fica quebrado quando viola as regras do Schema.org ou as exigências do Google: faltam campos obrigatórios, há valores no formato errado ou existem dois blocos de schema do mesmo tipo na página. O Google rastreia a marcação, encontra o erro e simplesmente ignora o rich snippet, mantendo o resultado comum.

Como identificar

No Teste de Resultados Aprimorados do Google aparece “Campo obrigatório ausente” ou “Valor inválido” para um tipo de schema.
No Search Console, o relatório de Aprimoramentos lista itens “inválidos” para FAQ, Produto, Receita ou Artigo.
Os rich snippets (estrelas, FAQ, preço) sumiram dos resultados de busca da página, que volta ao formato comum.
O Validador do Schema.org acusa dois blocos JSON-LD do mesmo @type na mesma URL.

Como prevenir

Mantenha um único gerador de schema ativo no site, normalmente o plugin de SEO, e desligue o schema nativo do tema
Após trocar de tema ou de plugin de SEO, rode o Teste de Resultados Aprimorados nas páginas principais
Acompanhe o relatório de Aprimoramentos no Search Console para detectar itens inválidos cedo

Causa

Dois plugins gerando schema ao mesmo tempo (por exemplo, o plugin de SEO e o tema, ou dois plugins de SEO), criando marcação duplicada e conflitante.
Campo obrigatório ausente para o tipo, como author e datePublished em Article ou price e availability em Product.
Valor no formato errado, como uma data fora do padrão ISO 8601 ou um aggregateRating sem ratingValue.
Bloco JSON-LD com erro de sintaxe (vírgula sobrando, aspas erradas) que invalida toda a marcação.
Schema de avaliação (review) referenciando estrelas que não existem de fato na página, contra a política do Google.

Como resolver

Rode o Teste de Resultados Aprimorados: cole a URL da página no Teste de Resultados Aprimorados do Google. Ele aponta exatamente qual tipo de schema está com erro e qual campo está faltando ou inválido.
Identifique se há schema duplicado: veja o código-fonte da página (Ctrl+U) e procure por 'application/ld+json'. Se houver dois blocos do mesmo tipo, dois geradores estão ativos. Desative o schema de um deles.
Desligue o schema do tema ou do plugin redundante: no plugin de SEO (Rank Math ou Yoast), confirme que ele é o único gerando schema. Em Aparência ou nas opções do tema, desative a marcação estruturada nativa do tema se ela existir.
Preencha os campos obrigatórios: nas configurações de schema do plugin de SEO, defina o tipo correto por post (Artigo, Produto, FAQ) e garanta que autor, data, imagem e demais campos exigidos estejam preenchidos.
Revalide e solicite reindexação: rode o teste do Google de novo até não restar erro. Depois, no Search Console, use a Inspeção de URL e clique em Solicitar indexação para o Google reprocessar a marcação.

JSON

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Titulo exato do artigo",
  "image": ["https://seudominio.com/wp-content/uploads/imagem.jpg"],
  "datePublished": "2026-01-15T08:00:00-03:00",
  "dateModified": "2026-01-20T10:30:00-03:00",
  "author": {
    "@type": "Person",
    "name": "Nome do Autor"
  }
}

Perguntas frequentes

O que é schema markup no WordPress?

É um código em JSON-LD que descreve o conteúdo da página para o Google, habilitando os resultados aprimorados como estrelas de avaliação, FAQ e dados de produto. No WordPress, ele é gerado pelo plugin de SEO ou pelo tema, sem você precisar escrever o código à mão.

Por que meus rich snippets sumiram do Google?

Porque a marcação ficou inválida: o Google rastreia o schema, encontra um campo obrigatório faltando, um valor no formato errado ou marcação duplicada, e ignora o rich snippet. O resultado volta ao formato comum. O Teste de Resultados Aprimorados mostra qual erro derrubou o snippet.

Como sei qual campo está quebrando o schema?

Use o Teste de Resultados Aprimorados do Google: cole a URL e ele lista o tipo de schema e o campo exato com problema, como 'author ausente' ou 'datePublished inválido'. O Validador do Schema.org complementa, apontando erros de sintaxe e blocos duplicados.

Dois plugins podem causar schema duplicado?

Sim, e é uma das causas mais comuns. Quando o plugin de SEO e o tema (ou dois plugins de SEO) geram schema ao mesmo tempo, a página fica com dois blocos do mesmo tipo, o que o Google trata como erro. A correção é deixar só um gerador de schema ativo.

Preciso editar código para corrigir o schema?

Na maioria dos casos, não. O ajuste é feito nas configurações do plugin de SEO: escolher o tipo correto por post e preencher os campos obrigatórios. Editar o JSON-LD à mão só é necessário em marcação personalizada, e mesmo assim com cuidado para não duplicar o schema do plugin.

Depois de corrigir, quando os rich snippets voltam?

Depende de quando o Google rastrear a página de novo. Para acelerar, valide a correção no Teste de Resultados Aprimorados e, no Search Console, use a Inspeção de URL e clique em Solicitar indexação. A volta dos snippets costuma levar de alguns dias a poucas semanas.

Atenção

Como corrigir URLs canônicas duplicadas no WordPress

O canonical duplicado no WordPress acontece quando a mesma página emite duas tags canônicas, geralmente porque dois plugins de SEO ou o tema as inserem ao mesmo tempo. O Google ignora as duas tags conflitantes e escolhe sozinho a URL canônica, o que pode consolidar a página errada e diluir a autoridade.

Informativo

Como corrigir o score baixo no Content Analysis do Rank Math no WordPress

O Rank Math content score baixo aparece quando a Focus Keyword não esta preenchida ou não casa com título, URL e primeiro paragrafo, deixando o Content Analysis reprovar os testes basicos de SEO no editor.

Atenção

Como corrigir o erro de schema markup no SEOPress

O erro de schema markup no SEOPress acontece quando o JSON-LD gerado pelo módulo Structured Data Types fica sem uma propriedade obrigatoria, recebe um campo dinâmico vazio ou e duplicado por outro plugin, e o Google deixa de usar a marcacao.

Grave

Como corrigir meta tags do Rank Math que não aplicam em templates do Elementor

As meta tags do Rank Math não aplicam em templates do Elementor quando o tema ou o Elementor Theme Builder emite a própria title tag no head, concorrendo com a saida do Rank Math. A correção e garantir uma única fonte de title e meta description por página.

Grave

Como corrigir o sitemap XML que não gera no SEOPress

Quando o sitemap do SEOPress não funciona, o arquivo em seudominio.com/sitemaps.xml/ devolve 404, página em branco ou e tratado como HTML pelo Search Console. A causa costuma ser a opção do sitemap desligada em SEO -> XML – HTML Sitemap, links permanentes em Simples sem reescrita, ou cache servindo uma versão antiga.

Informativo

Como corrigir o erro de llms.txt no SEOPress

O erro de llms.txt no SEOPress acontece quando o recurso esta desligado no painel ou quando as regras de reescrita do WordPress não foram atualizadas, fazendo o endereco /llms.txt retornar 404 ou vir em branco.

Setores

Extensões

Integrações

Como corrigir schema markup quebrado no WordPress

O que é o schema markup quebrado?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir URLs canônicas duplicadas no WordPress

Como corrigir o score baixo no Content Analysis do Rank Math no WordPress

Como corrigir o erro de schema markup no SEOPress

Como corrigir meta tags do Rank Math que não aplicam em templates do Elementor

Como corrigir o sitemap XML que não gera no SEOPress

Como corrigir o erro de llms.txt no SEOPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos