Schema Rank Math inválido: como corrigir a marcação

Tipo SEO Tecnico

Nome do erro Marcação inválida no Schema Generator do Rank Math EN: Rank Math Schema Generator invalid markup

Severidade Grave

Descrição A marcação inválida no Schema do Rank Math ocorre quando o JSON-LD do Schema Generator tem campo obrigatório faltando, propriedade aninhada no grupo errado ou variável vazia, e o Google ignora o rich snippet. A causa mais comum é um campo exigido (autor, imagem) ausente ou um aggregateRating no grupo errado.

O que é a marcação inválida do Schema do Rank Math?

O Schema Generator é o construtor de dados estruturados do Rank Math, na aba Schema do editor de posts. Ele monta o JSON-LD que descreve o conteúdo para o Google e habilita os resultados aprimorados, como estrelas de avaliação, FAQ e dados de produto. A marcação fica inválida quando viola as regras do Schema.org ou as exigências do Google: falta um campo obrigatório do tipo escolhido, uma propriedade foi colocada sob o grupo errado na hierarquia, uma variável dinâmica (como %title% ou %customfield(nome)%) retorna vazia, ou o valor está no formato errado. O Google rastreia a página, encontra o erro e ignora o rich snippet, mantendo o resultado comum.

Como identificar

Na aba Code Validation do Schema Generator, o botão Test with Google retorna ‘Campo obrigatório ausente’ ou ‘Valor inválido’ para o tipo de schema.
No Teste de Resultados Aprimorados do Google aparece um erro de campo faltando (por exemplo author ou image em Article, price em Product).
No Search Console, o relatório de Aprimoramentos lista a página como ‘inválida’ para Artigo, Produto, FAQ ou Avaliação.
Os rich snippets (estrelas, FAQ, preço) sumiram da página nos resultados de busca, que voltou ao formato comum.
O Schema Markup Validator do Schema.org acusa dois blocos JSON-LD do mesmo @type na mesma URL.

Como prevenir

Mantenha um único gerador de schema ativo: deixe o Rank Math gerar a marcação e desligue o schema nativo do tema e de outros plugins de SEO.
Sempre rode o Test with Google na aba Code Validation antes de publicar um post com schema personalizado.
Ao usar variáveis dinâmicas, confirme que o campo personalizado referenciado existe no tipo de post, para a variável não retornar vazia.
Acompanhe o relatório de Aprimoramentos no Search Console para pegar itens inválidos logo nos primeiros dias.

Causa

Campo obrigatório do tipo escolhido deixado em branco no Schema Generator, como author e datePublished em Article ou price e availability em Product.
Propriedade aninhada no grupo errado da hierarquia, por exemplo aggregateRating colocado dentro do grupo Review em vez de Product, o que muda o significado da marcação.
Variável dinâmica que retorna vazia, como %customfield(nome)% apontando para um campo personalizado que não existe no post, deixando o valor nulo no JSON-LD.
Dois geradores de schema ativos ao mesmo tempo (o template do Rank Math e o schema nativo do tema, ou um segundo plugin de SEO), produzindo marcação duplicada do mesmo tipo.
Schema de avaliação (Review) declarando estrelas que não existem de fato na página, o que o Google trata como marcação contra a política e ignora.
Valor no formato errado, como uma data fora do padrão ISO 8601 ou um price escrito com símbolo de moeda em vez de número puro.

Como resolver

Valide a marcação atual e leia o erro exato: abra o post, vá na aba Schema do Rank Math, entre na aba Code Validation e clique em Test with Google. O Google aponta o tipo de schema e o campo exato com problema. Salve um rascunho antes, porque o teste exige a página salva.
```
Rank Math -> Editor do post -> aba Schema -> Schema Generator -> Code Validation -> Test with Google
```
Preencha os campos obrigatórios do tipo: no Schema Generator, selecione o schema em uso e preencha as propriedades exigidas que o teste apontou como ausentes. Para Article costumam faltar autor, imagem e data; para Product, preço e disponibilidade.
```
Article -> author, image, datePublished, headline
Product -> name, price, availability, image
```
Corrija o aninhamento das propriedades: use as linhas de hierarquia do construtor para conferir o grupo de cada propriedade. Arraste a propriedade aninhada no lugar errado para o grupo correto. O caso clássico é mover o aggregateRating do grupo Review para o grupo Product.
```
aggregateRating -> mover do grupo Review para o grupo Product
```
Troque variáveis vazias por valor fixo ou variável válida: abra cada propriedade que usa variável dinâmica e confirme que ela retorna valor. Se a variável de campo personalizado aponta para um campo que não existe no post, substitua por uma variável padrão ou digite o valor manualmente.
```
%customfield(nome)% -> %title% ou valor fixo
```
Elimine o schema duplicado: veja o código-fonte da página com Ctrl+U e procure por application/ld+json. Se houver dois blocos do mesmo @type, desligue o schema nativo do tema ou o segundo plugin de SEO e deixe só o Rank Math gerando a marcação.
```
Ctrl+U -> procurar por application/ld+json (deve haver só um bloco por @type)
Aparência -> opções do tema -> desativar schema/dados estruturados nativos
```
Revalide e solicite reindexação: rode o Test with Google de novo até zerar os erros. Depois, no Search Console, use a Inspeção de URL e clique em Solicitar indexação para o Google reprocessar a marcação corrigida.
```
Search Console -> Inspeção de URL -> Solicitar indexação
```

JSON

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Nome exato do produto",
  "image": ["https://seudominio.com/wp-content/uploads/produto.jpg"],
  "offers": {
    "@type": "Offer",
    "price": "199.90",
    "priceCurrency": "BRL",
    "availability": "https://schema.org/InStock"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "37"
  }
}

Perguntas frequentes

O que é o Schema Generator do Rank Math?

É o construtor de dados estruturados do Rank Math, na aba Schema do editor de posts. Ele monta o JSON-LD que descreve o conteúdo para o Google e habilita rich snippets como estrelas, FAQ e dados de produto, sem você escrever o código à mão. A versão PRO permite criar schema personalizado e salvar templates.

Por que o schema do Rank Math fica inválido?

Porque a marcação viola as regras do Google: falta um campo obrigatório do tipo, uma propriedade está aninhada no grupo errado, uma variável dinâmica retornou vazia ou o valor está no formato errado. O Google rastreia o JSON-LD, encontra o erro e ignora o rich snippet, deixando o resultado comum.

Como descubro qual campo está quebrando o schema?

Na aba Schema do post, abra a aba Code Validation e clique em Test with Google. O teste lista o tipo de schema e o campo exato com problema, como author ausente ou datePublished inválido. O Schema Markup Validator do Schema.org complementa, apontando erros de sintaxe e blocos duplicados.

Por que meus rich snippets sumiram mesmo com o schema preenchido?

Pode haver schema duplicado: se o tema ou outro plugin de SEO também gera marcação, a página fica com dois blocos do mesmo tipo e o Google trata como erro. Outra causa é o schema declarar dados que não existem na página, como estrelas sem avaliações reais. Deixe só o Rank Math gerando o schema e remova claims sem lastro.

O que significa o erro de propriedade aninhada no grupo errado?

Significa que uma propriedade foi colocada sob o grupo de schema errado na hierarquia do construtor. O caso mais comum é o aggregateRating dentro do grupo Review em vez do grupo Product, o que muda o significado da marcação. As linhas de hierarquia do Schema Generator mostram a quem cada propriedade pertence; basta movê-la para o grupo certo.

Preciso editar JSON-LD à mão para corrigir?

Na maioria dos casos, não. O ajuste é feito no próprio Schema Generator: preencher os campos obrigatórios, corrigir o aninhamento e trocar variáveis vazias. Editar o JSON-LD diretamente só faz sentido em schema bem personalizado, e com cuidado para não duplicar a marcação que o Rank Math já gera.

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 Test with Google 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, e o Google ainda decide a exibição mesmo com schema válido.

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.

Atenção

Como corrigir a importação de dados do Yoast para o SEOPress no WordPress

O erro ao importar o Yoast para o SEOPress acontece quando a migração em SEO > Ferramentas > Plugins não conclui ou não traz títulos, meta descriptions e focus keywords, geralmente por rodar os dois plugins ao mesmo tempo, versão antiga do SEOPress ou processo interrompido por timeout.

Atenção

Como corrigir o Local SEO do SEOPress que não funciona no WordPress

O Local SEO do SEOPress não funciona quando o módulo Local Business está sem licença PRO ativa, com campos obrigatórios em branco ou com o schema LocalBusiness bloqueado por cache, conflito de plugin ou dado incompleto, fazendo o negócio local não aparecer para o Google.

Atenção

Como corrigir o Rank Math Content AI que não gera sugestões no WordPress

O Rank Math Content AI não gera sugestões quando a conta Rank Math está desconectada do site, os créditos mensais do plano Content AI se esgotaram ou o plugin está desatualizado, impedindo que a pesquisa do servidor retorne palavras-chave, perguntas e recomendações.

Atenção

Como corrigir o erro de canonical URL no SEOPress

O canonical errado no SEOPress acontece quando a tag rel canonical da página aponta para um endereco diferente do esperado, geralmente por um valor manual preso no campo Canonical URL da aba Advanced, por divergencia de www ou https no endereco do site, ou por um segundo plugin de SEO emitindo a própria tag.

Atenção

Como corrigir breadcrumbs duplicados entre Rank Math e SEOPress no WordPress

Breadcrumbs duplicados entre Rank Math e SEOPress acontecem quando os dois plugins (ou um plugin e o tema) imprimem a mesma trilha de navegação na página, geralmente por uma chamada de função manual somada ao breadcrumb automático, resultando em duas trilhas visiveis e dois blocos de schema BreadcrumbList.

Setores

Extensões

Integrações

Como corrigir marcação inválida no Schema Generator do Rank Math

O que é a marcação inválida do Schema do Rank Math?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

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

Como corrigir a importação de dados do Yoast para o SEOPress no WordPress

Como corrigir o Local SEO do SEOPress que não funciona no WordPress

Como corrigir o Rank Math Content AI que não gera sugestões no WordPress

Como corrigir o erro de canonical URL no SEOPress

Como corrigir breadcrumbs duplicados entre Rank Math e SEOPress no WordPress

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