Mode d’emploi

Saisissez chaque question et sa réponse telles qu’elles apparaissent sur votre page.
Ajoutez des paires, déplacez-les vers le haut ou vers le bas, ou supprimez celles dont vous n’avez pas besoin. Les paires incomplètes sont ignorées et signalées.
Copiez le script et collez-le dans le HTML de la page, dans l’en-tête ou dans le corps.
Testez la page avec un validateur de données structurées pour vérifier que le balisage est correctement interprété.

Fonctionnement

Le générateur crée un objet schema.org FAQPage avec une Question par paire, chacune contenant une acceptedAnswer de type Answer. Le JSON est produit à l’aide d’un véritable sérialiseur JSON : les guillemets, les barres obliques inverses et les retours à la ligne de votre texte sont donc correctement échappés. De plus, chaque « < », « > » et « & » est converti en séquence d’échappement \u. Cela empêche un texte comme « </script> » ou « <!-- » dans une réponse de fermer prématurément l’élément script et de rendre la page invalide, tout en permettant aux analyseurs JSON de retrouver les caractères d’origine.

À propos des résultats enrichis : en août 2023, Google a limité les résultats enrichis FAQ aux sites gouvernementaux et de santé reconnus et faisant autorité. Pour la plupart des autres sites, le balisage FAQPage ne génère plus de questions dépliables dans Google Search. Il reste des données structurées valides qui décrivent la page, et d’autres services utilisant les données schema.org peuvent s’en servir.

Règles à respecter : les questions et réponses du balisage doivent aussi être visibles sur la page ; chaque question doit avoir une seule réponse rédigée par le site (pour les pages où les utilisateurs peuvent envoyer des réponses, le type approprié est QAPage) ; et le balisage ne doit pas servir à faire de la publicité. Les réponses peuvent contenir du HTML simple, comme des liens et des listes, que les consignes de Google autorisent dans le texte des réponses.

Exemples

Page d’assistance produit

Trois questions sur la livraison, les retours et la garantie deviennent une FAQPage contenant trois éléments Question. Collez le script une seule fois sur la page d’assistance où figurent ces questions.

Une réponse contenant du code

Une réponse contenant « </script> » est convertie en \u003c/script\u003e dans le JSON. La balise script de la page reste ainsi intacte et le texte visible n’est pas modifié.

Foire aux questions

Le balisage FAQ donnera-t-il des résultats enrichis à ma page dans Google ?

Probablement pas, sauf s’il s’agit d’un site gouvernemental ou de santé reconnu et faisant autorité. En 2023, Google a réservé les résultats enrichis FAQ à ces sites. Le balisage reste valide et peut être lu par d’autres services.

Où dois-je placer le script JSON-LD ?

N’importe où dans le HTML, dans l’en-tête ou dans le corps de la page. Il n’affiche rien. Ajoutez-le uniquement à la page qui présente réellement ces questions et réponses.

Puis-je inclure des liens dans les réponses ?

Oui. Les consignes de Google pour les FAQ autorisent un nombre limité de balises HTML dans les réponses, comme les liens, les listes et les paragraphes. Saisissez le HTML dans la réponse ; il sera échappé de manière sécurisée pour le script.

Pourquoi la sortie contient-elle des séquences \u003c ?

Il s’agit de la séquence d’échappement JSON pour « < ». Cette écriture empêche le contenu de vos réponses de fermer la balise script. Tout lecteur JSON-LD la reconvertit en « < ».

Confidentialité

Le balisage est généré dans votre navigateur. Vos questions et réponses ne sont ni envoyées ni enregistrées.