Rich Snippets Schema Inválido: Como Corrigir

Tipo SEO Tecnico

Nome do erro Rich Snippets inválidos no schema do WordPress EN: Invalid rich snippets in WordPress schema

Severidade Atenção

Descrição Rich snippets schema inválido é quando a marcação JSON-LD da página existe, mas o Rich Results Test do Google a rejeita por campo obrigatório ausente ou tipo incorreto, então o resultado rico nunca aparece na busca.

O que é rich snippets schema inválido?

Rich snippets schema inválido acontece quando o WordPress entrega a marcação estruturada (JSON-LD) na página, porém o Google a considera incompleta ou malformada e descarta a elegibilidade para resultado rico. A documentação do Rank Math é explícita: ter o Schema certo importa mais do que apenas ter Schema, e uma marcação errada ou incompleta faz o Google não considerar a página para rich results. Diferente de schema ausente, aqui o código está presente e até pode parecer correto no editor, mas falha na validação oficial do Rich Results Test por um campo obrigatório faltando, um tipo de dado trocado ou aninhamento errado das propriedades.

Como identificar

No Rich Results Test (search.google.com/test/rich-results) aparece a mensagem ‘Campo obrigatório ausente’ ou ‘Missing field’ apontando uma propriedade do Schema
Na aba Code Validation do Schema Generator do Rank Math, ao clicar em ‘Test with Google’, o resultado mostra erros em vermelho em vez de ‘Página elegível para resultados avançados’
No Google Search Console, em Aprimoramentos, o item do tipo de schema aparece com status ‘Inválido’ e contador de itens com erro
O snippet rico (estrelas, FAQ, breadcrumb, preço) some da SERP mesmo dias depois da publicação, exibindo só o resultado azul padrão
O validator.schema.org acusa ‘A value for the X property is required’ ou ‘X is not a known property of type Y’

Como prevenir

Escolha o tipo de schema que casa com o conteúdo (Article para post, Product para produto, FAQPage só com pares reais de pergunta e resposta) antes de publicar
Rode o Rich Results Test em toda página nova ou alterada e só publique quando o resultado indicar elegibilidade, sem campos obrigatórios faltando
Mantenha uma única fonte de schema por tipo, desativando a marcação do tema quando o Rank Math já cobre aquele tipo, para evitar blocos duplicados
Acompanhe o relatório de Aprimoramentos do Search Console semanalmente para pegar itens marcados como Inválido logo após cada deploy
Ao usar variáveis do Schema Generator, confira que os custom fields referenciados existem e estão preenchidos antes de salvar o post

Causa

Propriedade obrigatória do tipo de schema está ausente, por exemplo Article sem 'headline' ou 'image', Product sem 'offers' ou 'review', e o Rich Results Test bloqueia por 'Missing field'.
Tipo de schema errado para o conteúdo, como aplicar Article numa página de produto WooCommerce ou FAQPage num post sem pares pergunta e resposta reais, gerando incompatibilidade entre dado e tipo.
Tipo de dado trocado numa propriedade, por exemplo um texto onde o Google espera número (ratingValue) ou uma data fora do formato ISO 8601 em datePublished, o que dispara 'data type mismatch'.
Schema duplicado porque o tema (Astra, Divi, GeneratePress) emite a própria marcação ao mesmo tempo que o Rank Math, criando dois blocos JSON-LD do mesmo tipo na página e confundindo o parser do Google.
Variável do Schema Generator do Rank Math não resolveu, deixando o placeholder literal (%title%, %customfield(preco)%) no JSON-LD final porque o custom field referenciado está vazio ou tem nome errado.
Google ainda não recrawleou a URL após a correção, então o snippet permanece ausente por atraso de reindexação mesmo com o schema já válido.

Como resolver

Identifique o erro exato no Rich Results Test: Antes de mexer no código, descubra qual propriedade o Google reprova. Cole a URL pública da página no teste oficial e leia a mensagem em vermelho, que nomeia o campo e o tipo de schema com problema.
```
https://search.google.com/test/rich-results
```
Abra o Schema Generator do post no Rank Math: No editor do post, abra o painel do Rank Math pela engrenagem na barra lateral do Gutenberg, vá até a aba Schema e clique em Schema Generator. Use o caminho do menu abaixo para confirmar que está no tipo de schema correto para o conteúdo da página.
```
Rank Math (barra lateral) -> aba Schema -> Schema Generator -> Custom Schema
```
Preencha a propriedade obrigatória que faltava: Dentro do Schema Builder, clique em Add Property e insira o campo que o teste apontou como ausente. Se o valor vier de um custom field, garanta que a variável referencia um campo que de fato existe e está preenchido, senão o placeholder fica literal no JSON-LD.
```
Schema Builder -> Add Property -> headline -> %title%
Schema Builder -> Add Property -> image -> %post_thumbnail%
```
Revalide pela aba Code Validation antes de salvar: Ainda no Schema Builder, salve o post como rascunho, abra a aba Code Validation, confira o JSON-LD gerado e clique em Test with Google. Repita até o resultado mostrar a página elegível, sem erros em vermelho.
```
Schema Builder -> aba Code Validation -> Test with Google
```
Remova o schema duplicado do tema: Se o teste acusar dois blocos do mesmo tipo, desative a emissão de schema no tema para deixar só a do Rank Math. Em temas como Astra, faça isso nas opções de Schema Markup do tema; mantenha apenas uma fonte de marcação por tipo.
```
Aparência -> Personalizar -> Schema Markup (tema) -> desativar
Rank Math -> Titles & Meta -> [tipo de post] -> Schema Type
```
Force o recrawl da URL no Search Console: Com o schema já válido, peça ao Google para reprocessar a página. Cole a URL na inspeção de URL do Search Console e clique em Solicitar indexação; o rich snippet pode levar dias para voltar à SERP após o novo crawl.
```
Google Search Console -> Inspeção de URL -> Solicitar indexação
```

HTML

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Como configurar cache no WordPress",
  "image": ["https://exemplo.com/wp-content/uploads/capa.jpg"],
  "datePublished": "2026-06-17T08:00:00-03:00",
  "author": { "@type": "Person", "name": "Equipe FULL" },
  "publisher": {
    "@type": "Organization",
    "name": "FULL Services",
    "logo": { "@type": "ImageObject", "url": "https://exemplo.com/logo.png" }
  }
}
</script>

Perguntas frequentes

Por que meu rich snippet some mesmo com o schema na página?

Porque presença não é validade. Se o Rich Results Test acusa um campo obrigatório ausente ou um tipo de dado errado, o Google descarta a elegibilidade e exibe só o resultado padrão, mesmo com o JSON-LD presente na página.

Como saber qual campo do schema está inválido?

Cole a URL pública no Rich Results Test do Google. Ele lista cada erro em vermelho nomeando a propriedade e o tipo de schema, por exemplo 'Missing field image' em Article, o que aponta exatamente o que preencher no Schema Generator.

Schema duplicado entre tema e Rank Math quebra o rich snippet?

Sim. Quando o tema emite a própria marcação além da do Rank Math, a página fica com dois blocos JSON-LD do mesmo tipo e o parser do Google pode rejeitar ou ignorar ambos. Mantenha apenas uma fonte de schema por tipo.

Quanto tempo o rich snippet leva para voltar depois da correção?

Não é imediato. Mesmo com o schema válido, o Google só reconsidera a página para resultado rico após um novo crawl. Solicitar indexação no Search Console acelera, mas a volta do snippet costuma levar de horas a alguns dias.

FAQPage e Article pedem as mesmas propriedades obrigatórias?

Não. Cada tipo tem campos próprios: Article exige headline e geralmente image, FAQPage exige pares de pergunta e resposta reais visíveis na página. Usar o tipo errado para o conteúdo gera incompatibilidade e reprovação no teste.

Por que aparece %title% literal no meu JSON-LD?

A variável do Schema Generator não resolveu. Isso ocorre quando o custom field referenciado está vazio ou tem nome diferente. Confira a variável na aba Code Validation e aponte para um campo que exista e esteja preenchido.

Validar pelo validator.schema.org é o mesmo que o Rich Results Test?

Não são equivalentes. O validator.schema.org checa a sintaxe contra o vocabulário Schema.org, enquanto o Rich Results Test verifica os requisitos específicos do Google para resultado rico. Use o do Google para elegibilidade e o Schema.org para tipos que o Google não cobre.

Atenção

Como corrigir schema markup quebrado no WordPress

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.

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.

Grave

Como corrigir meta description não aparecendo no Google

A meta description não aparecer no Google acontece quando o buscador descarta a descrição definida e gera o próprio trecho a partir do conteúdo da página. No WordPress, costuma vir de tag duplicada (tema + plugin de SEO), de cache com versão antiga ou de descrição generica.

Atenção

Como corrigir meta tags que não aplicam em templates Elementor no SEOPress no WordPress

O SEOPress Elementor meta tags não aplica quando o tema imprime o próprio título, quando o tipo de conteúdo esta sem template em Titles & Metas, ou quando o cache serve uma versão antiga. O resultado e título errado, meta description vazia ou tag de título duplicada na página do Elementor.

Atenção

Como corrigir canibalizacao de keyword no WordPress com Rank Math

A canibalizacao de keyword no WordPress ocorre quando duas ou mais páginas do mesmo site disputam o mesmo termo de busca, dividindo cliques, autoridade e sinais de relevancia. O Rank Math ajuda a detectar a focus keyword repetida e a corrigir com consolidacao, canonical ou redirecionamento 301.

Informativo

Como corrigir o Broken Link Checker no SEOPress

O erro do Broken Link Checker no SEOPress acontece quando o scan de links quebrados não roda, não retorna resultados ou trava, geralmente porque o recurso so existe no SEOPress PRO, o WP-Cron esta inativo ou o limite de execução do servidor interrompe o bot antes de terminar a varredura.

Setores

Extensões

Integrações

Como corrigir rich snippets inválidos no Schema do WordPress

O que é rich snippets schema inválido?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir schema markup quebrado no WordPress

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

Como corrigir meta description não aparecendo no Google

Como corrigir meta tags que não aplicam em templates Elementor no SEOPress no WordPress

Como corrigir canibalizacao de keyword no WordPress com Rank Math

Como corrigir o Broken Link Checker 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