--- title: "Como corrigir o FAQ Schema do Rank Math que não valida" url: https://full.services/wp-fixer/corrigir-faq-schema-rank-math/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o FAQ Schema do Rank Math que não valida ## 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 Erros relacionados - [Como corrigir marcação inválida no Schema Generator do Rank Math](https://full.services/wp-fixer/corrigir-schema-generator-rank-math/) - [Como corrigir rich snippets inválidos no Schema do WordPress](https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/) - [Como corrigir schema markup quebrado no WordPress](https://full.services/wp-fixer/corrigir-schema-markup-quebrado-wordpress/) --- ## Metadados Estruturados (Schema.org) ```json-ld { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://full.services/#org", "name": "FULL Services", "url": "https://full.services/", "sameAs": [ "https://www.instagram.com/fullservicesbr", "https://www.facebook.com/fullservices.br", "https://www.linkedin.com/company/fullservicesbr/" ], "knowsAbout": [ "WordPress", "WordPress Hosting", "Web Development", "Performance Optimization", "WordPress Security", "SEO para WordPress" ], "award": [ "Gold Medal - The WP Weekly Awards 2023", "Gold Medal - The WP Weekly Awards 2024" ], "logo": { "@type": "ImageObject", "url": "https://full.services/wp-content/uploads/full-services-logo.png", "width": 200, "height": 60 }, "hasCredential": { "@type": "EducationalOccupationalCredential", "credentialCategory": "certification", "name": "CVE Numbering Authority (CNA)", "description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Válida desde 2022-05-03, com abrangência global.", "url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL", "recognizedBy": { "@type": "Organization", "name": "CISA — Cybersecurity and Infrastructure Security Agency", "url": "https://www.cisa.gov/", "sameAs": "https://www.cisa.gov/" } } }, { "@type": "TechArticle", "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/#article", "headline": "Como corrigir o FAQ Schema do Rank Math que não valida", "url": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:31-03:00", "dateModified": "2026-06-17T12:39:46-03:00", "author": { "@id": "https://full.services/#org" }, "publisher": { "@id": "https://full.services/#org" }, "isAccessibleForFree": false, "about": [ { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, { "@type": "Thing", "name": "SEO Tecnico" } ], "mentions": { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/" }, "wordCount": 924, "description": "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.", "articleSection": "SEO Tecnico", "keywords": "bloco faq rank math sem schema, faq by rank math nao gera schema, faq schema rank math nao valida, rank math faqpage erro rich results, validar faq schema rank math", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://rankmath.com/kb/rich-snippets/", "name": "Rank Math — How Schema (Rich Snippets) Works" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o FAQ Schema do Rank Math que não valida", "programmingLanguage": "JavaScript", "codeRepository": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/#faq-q1", "name": "Por que o FAQ Schema do Rank Math não aparece no código-fonte?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/#faq-q2", "name": "O Rich Results Test diz que o FAQ é válido mas não mostra o resultado rico. Por quê?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/#faq-q3", "name": "Preciso do Rank Math PRO para gerar FAQ Schema?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/#faq-q4", "name": "O que significa o erro 'Either name or text must be specified' no FAQ?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "É 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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/#faq-q5", "name": "Cache pode fazer o FAQ Schema não validar?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/#faq-q6", "name": "Posso usar o mesmo FAQ em várias páginas?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-faq-schema-rank-math/#faq-q7", "name": "Como faço o FAQ Schema aparecer em um Custom Post Type?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```