Rank Math FAQ Schema Não Valida: Como Corrigir

Tipo SEO Tecnico

Nome do erro FAQ Schema do Rank Math não valida EN: Rank Math FAQ Schema not validating

Severidade Atenção

Descrição O Rank Math FAQ Schema não valida quando algum par pergunta/resposta fica vazio, quando o bloco FAQ não é renderizado no conteúdo público da página, ou quando o cache serve uma versão antiga sem o bloco. O markup só sai como FAQPage se cada item tiver pergunta e resposta preenchidas.

O que é FAQ Schema do Rank Math que não valida?

O FAQ Schema do Rank Math é o JSON-LD do tipo FAQPage que o plugin injeta na página a partir do bloco FAQ by Rank Math (ou de um schema FAQPage montado no Schema Generator). Quando esse markup não é gerado, sai incompleto ou é recusado pelo Rich Results Test, dizemos que o FAQ Schema não valida. Na prática o problema quase nunca é o plugin: o Rank Math só emite o FAQPage para itens que tenham pergunta E resposta preenchidas e que estejam de fato visíveis no HTML público da página.

Vale separar dois efeitos distintos. Um é o schema inválido, com erro no Rich Results Test (campo obrigatório faltando, item vazio, conteúdo do schema diferente do texto visível). O outro é o schema válido que mesmo assim não vira rich result: desde agosto de 2023 o Google passou a mostrar o resultado rico de FAQ apenas para sites de governo e saúde, então um FAQPage perfeito pode validar e ainda assim não exibir o sanfonado na busca. Distinguir os dois evita horas perdidas tentando corrigir algo que está correto.

Como identificar

No Rich Results Test do Google aparece a mensagem ‘No items detected’ mesmo com o bloco FAQ na página
O Rich Results Test acusa erro ‘Either name or text must be specified’ ou ‘Missing field acceptedAnswer’ no item de FAQ
A aba Schema do Rank Math mostra o FAQPage, mas o JSON-LD não está no código-fonte da página publicada (Ctrl+U não acha ‘FAQPage’)
O validador do Schema.org marca o item de FAQ como vazio ou sem a propriedade ‘acceptedAnswer’
O Google Search Console reporta ‘FAQ inválidos’ ou para de mostrar o aprimoramento de Perguntas frequentes no relatório

Como prevenir

Sempre revise cada par pergunta e resposta antes de publicar; itens em branco quebram o FAQPage inteiro
Mantenha o FAQ dentro do conteúdo do post (bloco nativo), não em widgets de tema ou page builder fora do the_content
Inclua a purga de cache no checklist de publicação, especialmente em sites com WP Rocket, LiteSpeed ou CDN
Padronize que o texto do schema seja idêntico ao texto visível na página para evitar recusa por content mismatch
Lembre a equipe de que FAQ Schema válido não garante rich result desde agosto de 2023; meça pelo Search Console, não pela prévia visual

Causa

Um ou mais pares do bloco FAQ by Rank Math estão com o campo de pergunta ou de resposta vazio, então o Rank Math descarta o item e o FAQPage sai incompleto ou nem é emitido.
O conteúdo do FAQ é montado por um widget do Elementor ou do tema fora do the_content, e o Rank Math não enxerga esse HTML para gerar o schema a partir dele.
Um plugin de cache (WP Rocket, LiteSpeed Cache, W3 Total Cache) está servindo uma versão antiga da página, gerada antes de você inserir ou corrigir o bloco FAQ.
O texto do schema não bate com o texto visível na página (resposta editada no schema mas não no corpo), e o Rich Results Test recusa por 'content mismatch'.
A página é um Custom Post Type ou tipo de conteúdo sem o módulo Schema do Rank Math habilitado em Rank Math, Configurações do Schema, então nenhum JSON-LD é injetado.
O FAQPage valida sem erro, mas o Google não exibe o rich result porque desde agosto de 2023 o recurso só aparece para sites de governo e saúde.

Como resolver

Confirme que o markup existe no HTML público: Abra a página publicada em uma aba anônima, veja o código-fonte e procure pela string FAQPage. Se ela não estiver lá, o problema é geração de schema, não validação. Use a busca do navegador no código-fonte.
```
Ctrl+U na página publicada -> Ctrl+F -> FAQPage
view-source:https://seusite.com.br/sua-página/
```
Preencha todo par pergunta e resposta do bloco FAQ: No editor, selecione o bloco FAQ by Rank Math e verifique cada item. O Rank Math só inclui no FAQPage os itens que tiverem pergunta e resposta preenchidas. Apague os itens em branco e salve a página novamente para regenerar o schema.
```
Editor -> bloco 'FAQ by Rank Math' -> remover itens com campo vazio -> Atualizar
```
Garanta que o FAQ esteja dentro do the_content: Se o FAQ é renderizado por um widget de page builder fora do conteúdo principal, o Rank Math não o lê. Mova o FAQ para o bloco nativo dentro do corpo do post, ou monte um FAQPage manual na aba Schema apontando para o mesmo texto visível.
```
Editor do post -> aba 'Rank Math' -> 'Schema' -> 'Schema Generator' -> 'FAQ'
```
Limpe o cache da página: Depois de salvar, purgue o cache do plugin de cache e do CDN para que o visitante e o Google recebam o HTML novo já com o bloco FAQ. Sem isso o validador continua lendo a versão antiga sem schema.
```
WP Rocket -> Configurações -> 'Limpar cache'
LiteSpeed Cache -> 'Esvaziar tudo'
```
Valide no Rich Results Test e separe inválido de não exibido: Pela própria aba Schema do Rank Math, use Código de validação e Testar com Google para abrir o Rich Results Test com o markup. Se acusar erro, corrija o campo apontado. Se passar mas não mostrar prévia, o markup está correto e a ausência de rich result é a política do Google para FAQ, não um defeito do site.
```
Aba 'Schema' -> 'Code Validation' -> 'Test with Google'
https://search.google.com/test/rich-results
```

JavaScript

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "O FAQ Schema do Rank Math precisa do PRO?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Nao. O bloco FAQ by Rank Math gera o FAQPage na versao gratuita."
    }
  }]
}
</script>

Perguntas frequentes

Por que o FAQ Schema do Rank Math não aparece no código-fonte?

Quase sempre porque algum item do bloco FAQ está com pergunta ou resposta vazia, ou o FAQ é renderizado fora do the_content por um widget de page builder. O Rank Math só injeta o FAQPage para itens completos e visíveis no conteúdo do post.

O Rich Results Test diz que o FAQ é válido mas não mostra o resultado rico. Por quê?

Desde agosto de 2023 o Google só exibe o rich result de FAQ para sites de governo e saúde. Um FAQPage válido em um site comum continua correto, mas não gera o sanfonado na busca; isso é política do Google, não erro do seu site.

Preciso do Rank Math PRO para gerar FAQ Schema?

Não. O bloco FAQ by Rank Math e o JSON-LD do tipo FAQPage estão na versão gratuita. O PRO adiciona o Advanced Schema Editor e variáveis de custom field, úteis para casos complexos, mas o FAQ básico funciona sem ele.

O que significa o erro 'Either name or text must be specified' no FAQ?

É o Rich Results Test avisando que um item de FAQ está sem a pergunta (name) ou sem a resposta (text). Volte ao bloco FAQ, localize o item incompleto, preencha os dois campos e atualize a página para regerar o schema.

Cache pode fazer o FAQ Schema não validar?

Sim. Se o plugin de cache ou o CDN serve uma versão da página gerada antes de você inserir o bloco FAQ, tanto o visitante quanto o Google recebem o HTML antigo sem o JSON-LD. Purgar o cache após salvar resolve esse caso.

Posso usar o mesmo FAQ em várias páginas?

Não é recomendado. O Google considera Q&A duplicado em muitas páginas como motivo para ignorar o markup. Escreva perguntas e respostas específicas de cada página e mantenha o texto do schema igual ao texto visível.

Como faço o FAQ Schema aparecer em um Custom Post Type?

Habilite o módulo Schema do Rank Math para aquele tipo de conteúdo em Rank Math, Configurações do Schema, e então adicione o bloco FAQ ou um FAQPage manual no Schema Generator. Sem o módulo ativo para o CPT, nenhum JSON-LD é injetado.

Atenção

Como corrigir o sitemap multilingue do SEOPress com WPML no WordPress

O sitemap multilingue do SEOPress com WPML falha quando as URLs traduzidas ficam fora do XML, o sitemap retorna em branco ou da 404. As causas mais comuns são cache servindo o XML como HTML, permalinks desatualizados, URLs marcadas como noindex e a integração SEO do WPML inativa.

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.

Grave

Como corrigir o schema de produto do Rank Math no WooCommerce

O schema de produto do Rank Math no WooCommerce fica invalido quando o markup sai sem offers, review ou aggregateRating, quando aparece em páginas de arquivo, ou quando o WooCommerce duplica a marcacao Product.

Grave

Como corrigir robots.txt bloqueando páginas importantes no WordPress

Um robots txt no WordPress bloqueando páginas importantes acontece quando uma regra Disallow ampla impede o Google de rastrear seções do site, derrubando o tráfego orgânico. A causa mais comum é a opção 'Desencorajar mecanismos de busca' nas Configurações de Leitura ou uma regra herdada de plugin que barra pastas indevidas.

Atenção

Como corrigir o sitemap duplicado entre Rank Math, SEOPress e Yoast

O sitemap duplicado Rank Math, SEOPress e Yoast ocorre quando mais de um plugin de SEO fica ativo e cada um registra a rota sitemap_index.xml. O resultado são duas versões do mesmo sitemap na mesma URL, sitemaps órfãos no Search Console e indexação inconsistente. A correção é manter um único gerador de sitemap ativo.

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.

Setores

Extensões

Integrações

Como corrigir o FAQ Schema do Rank Math que não valida

O que é FAQ Schema do Rank Math que não valida?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o sitemap multilingue do SEOPress com WPML no WordPress

Como corrigir URLs canônicas duplicadas no WordPress

Como corrigir o schema de produto do Rank Math no WooCommerce

Como corrigir robots.txt bloqueando páginas importantes no WordPress

Como corrigir o sitemap duplicado entre Rank Math, SEOPress e Yoast

Como corrigir o erro de schema markup 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