Comment vérifier les données structurées JSON-LD d’une page web
Vérifiez le JSON-LD de n’importe quelle page web pour repérer les erreurs et les champs manquants, voir chaque élément schema.org qu’il décrit et lire le JSON de chaque bloc.
3 min de lecture
Pour vérifier le JSON-LD d’une page web, ouvrez le Validateur JSON-LD, collez l’adresse de la page et cliquez sur « Récupérer et valider le JSON-LD ». Le résultat répertorie chaque problème, chaque élément décrit par la page et le JSON de chaque bloc. Si la page ne présente aucun problème, le résumé s’affiche en vert.
Comment vérifier une page
- Ouvrez la page dans votre navigateur et copiez l’adresse dans la barre d’adresse.
- Collez-la dans le champ URL. Si l’adresse ne contient pas
https://, celui-ci est ajouté automatiquement. - Cliquez sur « Récupérer et valider le JSON-LD ».
- Lisez le résumé au-dessus des tableaux. Il indique le nombre de blocs, d’erreurs et d’avertissements.
- Choisissez un bloc sous « Source » pour afficher son JSON avec les numéros de ligne.
Comment lire le résultat
- Le tableau des problèmes répertorie chaque erreur et avertissement. Il apparaît uniquement en cas de problème.
- « Bloc » indique le numéro du bloc de script, en comptant depuis le haut de la page.
- « Emplacement » indique où se trouve le problème, par exemple
Product.image. - Le tableau des éléments répertorie chaque élément, avec son type, comme Article ou Product, et son nom.
- Cliquez sur un en-tête de colonne pour trier un tableau. Les boutons sous chaque tableau permettent de l’exporter en CSV ou en JSON.
Quels problèmes corriger en premier
Les erreurs apparaissent en premier dans la liste et sont signalées en rouge. Les avertissements sont signalés en jaune. Une erreur signifie qu’un élément est incorrect ou qu’un champ obligatoire est manquant. Les avertissements marqués « (facultatif) » concernent des champs que vous pouvez ajouter lorsque vous disposez des données.
Ces messages sont faciles à corriger.
| Message | Correctif |
|---|---|
| JSON invalide | Recherchez une virgule ou un guillemet manquant, ou une virgule après la dernière valeur. |
@context manquant, ajoutez "@context": "https://schema.org" |
Ajoutez cette ligne au bloc. |
| @type manquant | Ajoutez un type, par exemple "@type": "Product". |
| « "@Type" n’est pas un mot-clé JSON-LD » | Écrivez les mots-clés en minuscules : @type. |
| Le type « Organisation » n’est pas un type schema.org valide | Utilisez le nom exact de schema.org, ici Organization. |
| L’attribut obligatoire « image » est manquant | Ajoutez le champ indiqué dans le message. |
Quand la vérification ne trouve rien ou échoue
« Aucun bloc de script JSON-LD n’a été trouvé sur cette page » signifie que le code HTML de la page ne contient pas de JSON-LD. La vérification lit la page telle que le serveur l’envoie. Le JSON-LD ajouté ensuite par un script dans le navigateur n’est pas détecté.
« Échec de la récupération de la page » signifie que le site n’a pas envoyé la page. Cela se produit également lorsque l’adresse redirige vers une autre adresse, car les redirections ne sont pas suivies. Copiez l’adresse finale depuis la barre d’adresse et réessayez.
Seuls les 3 premiers Mo d’une page sont vérifiés. Un message vous indique si une page est plus volumineuse.
Corrigez les erreurs, mettez la page à jour et relancez la vérification.
Envie de l'essayer vous-même ?
Validateur JSON-LD
Saisissez une URL pour que le serveur récupère la page, extrait chaque bloc de données structurées JSON-LD et vérifie les erreurs de syntaxe JSON, l'absence de @context et de @type, les types et propriétés schema.org inconnus, ainsi que les champs nécessaires à Google pour les résultats enrichis.