Générateur de schema FAQ

Comment générer le balisage FAQ

Écrivez chaque paire une seule fois : le générateur produit les deux sorties à partir de la même liste, le balisage et la FAQ visible ne peuvent donc pas dire des choses différentes.

1. Saisissez vos questions et vos réponses. Une ligne par paire. Formulez la question comme elle est tapée dans un moteur de recherche, et faites de la première phrase de la réponse une réponse complète à elle seule.
2. Lisez les avertissements. Les lignes vides sont ignorées, une ligne avec seulement une question ou seulement une réponse est une erreur, les questions en double et les réponses trop longues sont signalées.
3. Collez le JSON-LD. Copiez le bloc script dans la page — head ou body, les deux fonctionnent — avec un seul FAQPage par page.
4. Collez le HTML visible. Copiez le bloc details/summary là où vos lecteurs verront la FAQ. Il contient exactement le texte que déclare le JSON-LD. Si vous modifiez l'un des deux plus tard, régénérez les deux.

Pourquoi le balisage doit correspondre mot pour mot au texte visible

Le balisage FAQ, ce sont des données structurées de type FAQPage — un bloc JSON-LD qui liste les questions et les réponses présentes sur une page — pour que les moteurs de recherche et les moteurs de réponse IA les lisent comme des données au lieu de les deviner à partir de la mise en page. Le mot qui décide de tout est présentes. Les consignes de Google sur les données structurées exigent que le contenu balisé soit visible par le lecteur et corresponde à ce que le balisage annonce. Une page dont le JSON-LD liste des questions que le visiteur ne voit pas, ou des réponses différentes de celles affichées, enfreint ces consignes et peut perdre son éligibilité aux données structurées par une action manuelle.

La plupart des générateurs s'arrêtent au JSON-LD et vous laissent la moitié visible. C'est là que la dérive commence : le texte est retouché dans le CMS, le bloc script ne l'est pas, et six mois plus tard le balisage décrit une page qui n'existe plus. Ce générateur écrit le HTML visible et le JSON-LD depuis la même liste, dans la même passe — le texte du <summary> est le name, celui du <p> est le acceptedAnswer.text, caractère par caractère. Régénérez les deux dès que vous en changez un et ils ne pourront pas se contredire.

La règle ne relève pas seulement de la conformité. Les moteurs de réponse IA reprennent la phrase visible, et le lecteur qui arrive sur la page à cause de cette citation s'attend à l'y trouver. Une source unique pour les deux surfaces, c'est la façon de s'en assurer.

Ce que le balisage FAQ apporte aujourd'hui, honnêtement

En août 2023, Google a réservé les résultats enrichis FAQ aux sites gouvernementaux et de santé reconnus et faisant autorité. Pour tous les autres, l'extrait déroulant sous le résultat a disparu, et tout outil qui le promet encore décrit l'année 2022. Alors pourquoi baliser une FAQ ?

• La FAQ visible se positionne. Une question formulée comme elle est cherchée, répondue en une phrase nette, est une section de page capable de se positionner seule et d'être citée par un moteur IA. Le balisage est la copie lisible par machine de cette section, pas la raison de son positionnement.
• Les données structurées restent lues. Google analyse le balisage FAQPage même là où il n'affiche aucun résultat enrichi, et d'autres consommateurs — Bing, les moteurs de réponse, vos propres agents — s'en servent comme d'un chemin d'extraction propre.
• La discipline paie ailleurs. Écrire une question comme une requête et une réponse comme une phrase autonome, c'est exactement ce qui fait citer une page dans les réponses IA, avec ou sans JSON-LD.

Ce qu'il ne faut pas en attendre : un gain de position dû au balisage lui-même, ou un résultat enrichi sur un site commercial. Utilisez-le parce que la page a une vraie FAQ et que vous voulez que ses deux surfaces disent la même chose.

Écrire des questions et des réponses qui se font citer

• Ne traduisez pas les questions depuis l'anglais. En français on cherche comment résilier, pas annulation d'abonnement ; on cherche combien de temps pour être livré, pas délais de livraison. Prenez la question dans la barre de recherche interne ou dans un e-mail client, pas dans le glossaire maison.
• Formulez-la comme une vraie requête. Comment faire pour…, Est-ce que je peux…, Faut-il… — telle qu'elle est tapée, pas comme un intitulé de rubrique.
• Répondez complètement dès la première phrase. Les extracteurs prennent la phrase d'ouverture ; le reste est du détail.
• Chaque phrase doit tenir seule. Pas de cela, ci-dessus ou comme indiqué plus haut : une phrase citée perd ses voisines.
• Une idée par paire. Une question qui demande trois réponses, ce sont trois questions.
• Des faits plutôt que des adjectifs. Les chiffres avec leur source se font citer, les superlatifs non.
• Uniquement des questions réellement posées. Une FAQ n'est pas l'endroit où cacher un argument commercial derrière un point d'interrogation.

Où placer chaque bloc

Le JSON-LD peut se trouver n'importe où dans la page, dans un <script type="application/ld+json"> — head ou body, Google lit les deux. Utilisez un seul bloc FAQPage par page et ne répétez pas les mêmes questions sur plusieurs URL : le balisage décrit la page sur laquelle il se trouve. Le bloc visible se place là où la FAQ doit être lue ; <details>/<summary> se replie et se déplie sans une ligne de JavaScript et reste dans le HTML pour les robots.

Une fois en place, vérifiez avec le Test des résultats enrichis de Google ou le validateur de schema.org : ils vous diront si le bloc est bien interprété comme une FAQPage, même si aucun aperçu de résultat enrichi ne s'affiche — depuis 2023 cet aperçu n'est proposé qu'aux sites encore éligibles. Et gardez en tête que FAQPage sert aux questions que le site pose et auxquelles il répond : une page où les visiteurs publient des questions et où d'autres répondent — un fil de forum, une communauté d'entraide — relève de QAPage, un type différent.

Le JSON-LD ne décrit que ce qui est sur cette page. Les versions linguistiques se déclarent à part avec le générateur de balises hreflang, et l'index que lit un agent se contrôle avec le validateur llms.txt — tous deux construits sur la même règle que cette page : une source, deux sorties, aucune dérive.

$ npm i -g @clize/clize && clize install
$ clize seo check --domain votredomaine.fr