Como corrigir marcação inválida no 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.

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.

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.

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.

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.

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.

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.