// FERRAMENTA GRÁTIS · GERADOR DE SCHEMA FAQ
Gerador de schema FAQ
Escreva suas perguntas e respostas uma única vez: você recebe o JSON-LD de FAQPage e o bloco de HTML visível que bate com ele palavra por palavra. Grátis, no seu navegador, pronto para colar.
Também emEnglish繁體中文日本語한국어EspañolFrançaisDeutschPortuguês (Brasil)
Só texto simples. As quebras de linha dentro de uma resposta são mantidas. Nada é enviado para lugar nenhum: o gerador é um script pequeno desta própria página.
Como gerar o schema de FAQ
Escreva cada par uma vez só; o gerador monta as duas saídas a partir da mesma lista, então a marcação e o FAQ visível não têm como dizer coisas diferentes.
- Adicione suas perguntas e respostas. Uma linha por par. Escreva a pergunta do jeito que alguém digita no buscador e faça a primeira frase da resposta responder sozinha.
- Leia os avisos. Linhas vazias são ignoradas, uma linha só com pergunta ou só com resposta é erro, e perguntas repetidas e respostas longas demais recebem aviso.
- Cole o JSON-LD. Copie o bloco script para a página — no head ou no body, tanto faz — com uma única FAQPage por página.
- Cole o HTML visível. Copie o bloco details/summary para onde o leitor vai ver o FAQ. Ele carrega exatamente o texto que o JSON-LD declara. Se depois você mudar um dos dois, gere os dois de novo.
Por que a marcação precisa bater palavra por palavra com o texto visível
O FAQ schema é um dado estruturado do tipo FAQPage — um bloco JSON-LD que lista as perguntas e respostas que aparecem na página — para que os buscadores e os mecanismos de resposta com IA as leiam como dados em vez de adivinhá-las pelo layout. A palavra que decide tudo é aparecem. As diretrizes de dados estruturados do Google exigem que o conteúdo marcado esteja visível para quem lê a página e seja igual ao que a marcação diz. Uma página cujo JSON-LD lista perguntas que o visitante não vê, ou respostas diferentes das exibidas, descumpre essas diretrizes e pode perder a elegibilidade a dados estruturados por uma ação manual.
A maioria dos geradores para no JSON-LD e deixa a metade visível com você. É aí que a divergência começa, e no Brasil ela tem uma forma bem conhecida: o bloco de perguntas vem do tema ou de um plugin, o JSON-LD vem de outro plugin, alguém ajusta o texto no editor do WordPress e ninguém volta na marcação. Seis meses depois o JSON-LD descreve uma página que não existe mais. Este gerador escreve o HTML visível e o JSON-LD a partir da mesma lista e na mesma passada — o texto do <summary> é o name, o do <p> é o acceptedAnswer.text, caractere por caractere. Gere os dois de novo sempre que mudar um, e eles não têm como se contradizer.
A regra não é só conformidade. Os mecanismos de resposta com IA levam a frase visível, e quem chega à página por causa dessa citação espera encontrá-la ali. Uma fonte só para as duas faces é o jeito de garantir que encontre.
O que o FAQ schema faz hoje, sem enrolação
Em agosto de 2023 o Google restringiu os resultados com FAQ na Busca a sites de governo e de saúde reconhecidos e com autoridade. Para todo o resto, o trecho de perguntas que abria embaixo do resultado sumiu, e qualquer ferramenta que ainda prometa isso está descrevendo 2022. Então por que marcar um FAQ?
- O FAQ visível ranqueia. Uma pergunta escrita do jeito que se busca, respondida em uma frase limpa, é um trecho de página capaz de ranquear sozinho e de ser citado por um mecanismo de IA. A marcação é a cópia legível por máquina desse trecho, não o motivo de ele ranquear.
- Os dados estruturados continuam sendo lidos. O Google processa a marcação FAQPage mesmo onde não mostra nenhum resultado aprimorado, e outros leitores — Bing, mecanismos de resposta, os seus próprios agentes — usam isso como caminho limpo de extração.
- A disciplina se paga em outro lugar. Escrever a pergunta como consulta e a resposta como frase que se sustenta sozinha é exatamente o que faz uma página ser citada em respostas de IA, com ou sem JSON-LD.
O que não esperar: ganho de posição pela marcação em si, ou um resultado aprimorado em um site comercial. Use porque a página tem um FAQ de verdade e você quer que as duas faces dela digam a mesma coisa.
Perguntas e respostas que acabam citadas
- Não traduza as perguntas do inglês. Em português se busca quanto tempo demora a entrega, não prazos de entrega; se busca como cancelar assinatura, não política de cancelamento. Tire a pergunta da busca interna do site ou do e-mail de um cliente, não do glossário da empresa.
- Escreva como uma consulta de verdade. Como faço para…, Quanto custa…, Precisa de… — do jeito que é digitado, não como título de seção.
- Responda por inteiro na primeira frase. Os extratores levam a frase de abertura; o resto é detalhe de apoio.
- Cada frase precisa se sustentar sozinha. Nada de isso, o acima ou como já dissemos: uma frase citada perde as vizinhas.
- Uma ideia por par. Uma pergunta que precisa de três respostas são três perguntas.
- Fatos em vez de adjetivos. Números com fonte são citados; superlativos não.
- Só perguntas que alguém faz. Um FAQ não é lugar de esconder argumento de venda atrás de um ponto de interrogação.
Onde entra cada bloco
O JSON-LD pode ficar em qualquer ponto da página, dentro de <script type="application/ld+json"> — head ou body, o Google lê os dois. Use um único bloco FAQPage por página e não repita as mesmas perguntas em várias URLs: a marcação descreve a página em que está. O bloco visível vai onde o FAQ deve ser lido; <details>/<summary> abre e fecha sem uma linha de JavaScript e continua no HTML para os rastreadores. No WordPress, cole o JSON-LD em um bloco de HTML personalizado e o bloco visível no conteúdo: sem plugin nenhum, os dois saem do mesmo lugar.
Depois de colocar, confira no Teste de resultados aprimorados do Google ou no validador do schema.org: eles dizem se o bloco é entendido como FAQPage e quais perguntas foram lidas. Não aparecer a prévia do resultado aprimorado não quer dizer que a marcação está errada — desde 2023 essa prévia só é oferecida aos sites que continuam elegíveis. Depois de publicar, o relatório de aprimoramentos do Search Console mostra quantas FAQPage foram detectadas e se há erros.
Vale lembrar que FAQPage é para as perguntas que o próprio site faz e responde. Uma página em que visitantes postam perguntas e outros respondem — um tópico de fórum, uma comunidade de suporte — é QAPage, outro tipo. E o JSON-LD só descreve o que está nesta página: as versões por idioma são declaradas com o gerador de tags hreflang e o índice que um agente lê é conferido no validador de llms.txt — os dois construídos com a mesma regra desta página: uma fonte, duas saídas, zero divergência.
// Perguntas frequentes
O que é FAQ schema?
O FAQ schema é um dado estruturado do tipo FAQPage — um bloco JSON-LD que lista as perguntas e respostas que aparecem na página — para que os buscadores e os mecanismos de resposta com IA as leiam como dados em vez de adivinhá-las pelo layout. Cada item é uma Question com uma acceptedAnswer cujo texto é igual à resposta exibida na página.
O Google ainda mostra resultados com FAQ na Busca?
Só em sites de governo e de saúde reconhecidos e com autoridade. O Google fez essa mudança em agosto de 2023, então na maioria dos sites o trecho de FAQ que abria embaixo do resultado não aparece mais. A marcação continua sendo lida e continua útil para os mecanismos de resposta, mas não é fator de posicionamento e não adiciona resultado aprimorado a uma página comercial.
Preciso de um plugin como Rank Math ou Yoast para colocar FAQ schema?
Não. O JSON-LD é um bloco de texto: cole em um bloco de HTML personalizado do WordPress, no tema ou no head e pronto. Os plugins também geram, mas quase sempre escrevem só o JSON-LD a partir de campos próprios, deixando o texto visível e a marcação em dois lugares que acabam divergindo; aqui os dois saem da mesma lista.
A marcação precisa ser igual ao texto visível da página?
Precisa. As diretrizes de dados estruturados do Google exigem que o conteúdo marcado esteja visível na página e seja igual a ela. Uma marcação que lista perguntas ou respostas que o leitor não vê descumpre essas diretrizes e pode custar à página a elegibilidade a dados estruturados. Este gerador escreve o HTML e o JSON-LD a partir da mesma lista, palavra por palavra.
FAQ schema melhora o posicionamento no Google?
Não. O Google não usa dados estruturados como fator de posicionamento. O que trabalha pelo posicionamento é o FAQ visível: a pergunta escrita como as pessoas buscam e a resposta que se resolve na primeira frase. A marcação torna esse conteúdo legível por máquina, não compra posição.
Como testo se a marcação FAQPage está válida?
Pelo Teste de resultados aprimorados do Google ou pelo validador do schema.org: cole a URL ou o código e a ferramenta diz se o bloco é reconhecido como FAQPage e quais perguntas foram detectadas. Depois de publicar, o relatório de aprimoramentos do Search Console acompanha quantas FAQPage o Google encontrou e quais deram erro.
FAQPage ou QAPage para perguntas enviadas por usuários?
QAPage. FAQPage é para as perguntas que o próprio site faz e responde. Uma página em que os visitantes postam perguntas e outros respondem — um tópico de fórum ou uma comunidade de suporte — deve usar o tipo QAPage.
Marcação no lugar? Meça a página, não a promessa.
Checar o seu próprio site não custa nada: posições e impressões do Search Console contra a janela anterior, suas páginas com o status HTTP e de indexação ao vivo, e o tráfego por origem com os mecanismos de IA listados à parte. Um comando de dentro do seu agente.
$ npm i -g @clize/clize && clize install $ clize seo check --domain seudominio.com.br[ Agent SEO da Clize → ]