Builder Rich Snippet FAQ

Você já tem a FAQ escrita na página e quer que o Google entenda que aquilo é uma lista de perguntas. Aí abre a documentação do schema.org, copia um exemplo, troca os textos e o Rich Results Test acusa erro — quase sempre uma vírgula sobrando ou uma chave que fechou no lugar errado. Escrever JSON-LD à mão é chato menos pela estrutura e mais pelo erro bobo que só aparece na validação.

Aqui você preenche dois campos, Pergunta e Resposta, e a saída é o bloco FAQPage inteiro, já dentro da tag script type=application/ld+json e indentado com dois espaços. Os textos passam por JSON.stringify antes de entrar no objeto, então aspas, barras e acentos na resposta não quebram nada. O limite é explícito: sai um par por vez. O array mainEntity vem com um único objeto Question, e para uma FAQ com cinco perguntas você duplica esse objeto cinco vezes, separando por vírgula.

Antes de investir tempo nisso, saiba que desde agosto de 2023 o Google restringiu o rich result de FAQ a sites governamentais e de saúde reconhecidos. A marcação continua válida e outros consumidores leem, mas o sanfoninha na SERP provavelmente não vem. Se for publicar, garanta que a pergunta e a resposta do JSON são exatamente as que o visitante vê na página — texto invisível marcado como FAQ é violação de diretriz. Tudo roda no navegador, nada é enviado para servidor.