Guide d’utilisation du Validateur JSON-LD Schema.org

Le Validateur JSON-LD Schema.org de SiteNova permet de vérifier en français le balisage structuré d’une page, sans passer par l’interface anglophone du Rich Results Test de Google. Ce guide détaille, étape par étape, comment lire les résultats de l’outil et corriger les erreurs qu’il remonte.

À quoi sert un validateur Schema.org JSON-LD

Le schema markup — ou données structurées — est un code ajouté dans le HTML d’une page pour expliquer à Google la nature exacte de son contenu : un article, une fiche produit, une FAQ, un établissement local, une recette. Ce balisage ne change rien à l’affichage visuel de la page pour un visiteur humain, mais il conditionne l’apparition de rich results dans les résultats de recherche — étoiles d’avis, questions dépliables, fil d’ariane, ou encore citations dans les résumés générés par IA.

Un validateur sert précisément à vérifier que ce code respecte la syntaxe attendue et contient les propriétés obligatoires pour le type de contenu déclaré. Sans validation, une erreur de syntaxe aussi simple qu’une virgule mal placée peut faire ignorer l’intégralité du bloc par Google, sans qu’aucun message d’erreur ne s’affiche côté site.

Étape 1 — Extraire le schema d’une URL

Sur la page du Validateur Schema JSON-LD, il suffit de coller l’URL complète de la page à analyser (avec son protocole https://) dans le champ prévu, puis de lancer l’extraction. L’outil récupère le HTML de la page et isole automatiquement chaque bloc <script type="application/ld+json"> présent dans le code source.

Étape 2 — Lire les types Schema.org détectés

Une fois l’extraction terminée, l’outil liste chaque type d’entité détecté (Article, FAQPage, LocalBusiness, Product, BreadcrumbList, etc.) avec l’ensemble des propriétés déclarées pour chacun. C’est à cette étape qu’il faut vérifier deux choses : que les types déclarés correspondent bien à la nature réelle de la page, et qu’aucun type pertinent n’a été oublié.

Une erreur fréquente consiste à déclarer un seul bloc générique quand la page mériterait plusieurs types complémentaires — par exemple un article de blog qui gagnerait à combiner Article, BreadcrumbList et, si la page contient des questions-réponses, FAQPage.

Étape 3 — Identifier les propriétés manquantes

Chaque type Schema.org possède des propriétés recommandées ou requises pour prétendre à un rich result. Le validateur signale les champs absents pour le type détecté. Le tableau suivant récapitule les propriétés les plus souvent manquantes selon le type de contenu, à partir des cas les plus fréquemment rencontrés en audit :

Étape 4 — Corriger sans casser le reste du balisage

Une fois les champs manquants identifiés, la correction se fait directement dans le générateur de balisage ou dans le thème/plugin SEO utilisé (Yoast, Rank Math, ou un champ personnalisé selon les sites). Trois règles simples évitent la majorité des erreurs de correction :

• Ne jamais déclarer une propriété qui ne correspond à rien de visible sur la page. Google peut considérer ce décalage comme du balisage trompeur, avec un risque de pénalité manuelle sur le spam structuré.
• Garder un seul bloc cohérent par type de contenu. Plusieurs blocs JSON-LD contradictoires sur une même page créent de la confusion et affaiblissent le signal envoyé à Google.
• Revalider après chaque correction. Une erreur de syntaxe (guillemet non fermé, virgule en trop) est facile à introduire en modifiant un champ manuellement ; une repasse dans l’outil confirme que le JSON reste valide.

Pour aller plus vite : générer le balisage plutôt que le corriger à la main

Sur un site neuf ou une page qui ne dispose d’aucun balisage, il est souvent plus rapide de partir d’un schema propre dès le départ plutôt que de corriger un balisage mal structuré après coup. Le Générateur Schema JSON-LD de SiteNova produit un code prêt à intégrer pour les six types les plus utilisés en SEO (Article, LocalBusiness, FAQPage, Product, BreadcrumbList, Organization), qu’il suffit ensuite de repasser dans le validateur pour confirmer sa conformité avant mise en ligne.

Ce que le validateur ne remplace pas

Cet outil donne un retour immédiat et en français sur la structure du balisage, mais il reste complémentaire de deux vérifications officielles Google, à effectuer avant toute mise en production sur un site à fort trafic :

• Le Rich Results Test de Google, qui simule précisément l’éligibilité aux rich results tels que Google les évalue réellement.
• Le rapport « Améliorations » de Search Console, qui remonte les erreurs détectées après indexation réelle des pages, sur la durée.

Le validateur SiteNova est pensé pour un premier contrôle rapide, en amont de la publication — pas comme un substitut définitif à ces deux outils officiels.

Checklist avant publication d’une page

Pour éviter les allers-retours après mise en ligne, voici les points à vérifier systématiquement avant de publier une page qui embarque du schema markup :

• Le type déclaré correspond au contenu réel de la page (pas de Product sur une page qui n’est pas une fiche produit, pas de FAQPage si les questions ne sont pas visibles dans le contenu).
• Toutes les propriétés obligatoires du type sont renseignées, sans champ vide ni valeur générique par défaut copiée d’un autre modèle de page.
• Les images référencées existent et sont accessibles publiquement, avec un format et une résolution conformes aux recommandations Google pour le type concerné.
• Un seul bloc JSON-LD par type de contenu, sans doublon issu d’un ancien plugin SEO resté actif après une migration.
• Le validateur ne remonte aucune propriété manquante pour le ou les types détectés, une fois la page repassée dans l’outil après correction.

Foire aux questions

Le validateur fonctionne-t-il sur n’importe quel site, pas seulement WordPress ?

Oui. L’outil analyse le HTML de n’importe quelle URL publique, quel que soit le CMS ou la technologie utilisée pour générer la page.

Que faire si l’outil ne détecte aucun schema sur ma page ?

Cela signifie qu’aucun bloc JSON-LD n’est présent dans le HTML retourné par le serveur. Si un plugin SEO est censé en générer un automatiquement, il faut vérifier sa configuration ou consulter le code source de la page directement (clic droit puis « Afficher le code source ») pour confirmer sa présence.

Une erreur de syntaxe empêche-t-elle tout le référencement de la page ?

Non. Une erreur dans le JSON-LD empêche uniquement ce bloc de données structurées d’être pris en compte pour les rich results ; elle n’affecte pas l’indexation classique du contenu texte de la page.

Faut-il valider le schema à chaque mise à jour de l’article ?

C’est recommandé, en particulier si la mise à jour touche l’auteur, la date de publication ou les images de l’article, puisque ces champs font partie des propriétés vérifiées par Google pour le type Article.