Vérification des données structurées

Une deuxième copie de la page, écrite pour les machines

Montrez une fiche produit à une personne : elle sait tout de suite quel nombre est le prix et lequel est le stock. Un programme, lui, ne voit que du texte. Les données structurées lui évitent de deviner. En plus de la page visible, vous publiez les mêmes faits sous forme de champs étiquetés, avec les noms du vocabulaire commun de schema.org. Cet objet est un Product, son name est celui-ci, ses offers contiennent un price de 49.00 en USD.

Il y a trois façons de l’écrire. Le JSON-LD met tout dans une seule balise script, à part de la mise en page. C’est la forme que Google recommande. Les microdonnées et le RDFa répartissent les étiquettes sur les balises HTML sous forme d’attributs.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How tides work",
  "datePublished": "2026-03-14T09:30:00+00:00",
  "author": { "@type": "Person", "name": "Jane Doe" }
}
</script>

Les moteurs de recherche utilisent ces champs pour afficher des résultats plus riches, avec des étoiles d’avis, un prix, la photo d’une recette ou la date d’un événement. On les appelle des résultats enrichis.

Ce que lit cette vérification

Notre serveur télécharge la page une seule fois, jusqu’à 3 Mo sans exécuter ses scripts. Ensuite, il procède en quatre étapes.

1. Syntaxe. Chaque bloc JSON-LD passe dans un lecteur JSON strict. À la première erreur, il donne la ligne, le caractère et la cause probable : une virgule avant une accolade fermante, un guillemet dans un texte sans échappement, des guillemets typographiques collés depuis un traitement de texte, un commentaire HTML, un saut de ligne brut. Une seule erreur suffit pour qu’un analyseur abandonne tout le bloc.
2. Éléments. Les listes @graph sont dépliées pour que chaque élément s’affiche séparément, avec son type et un aperçu de ses propriétés. Une propriété qui renvoie à un autre élément par @id est suivie quand la cible se trouve sur la page.
3. Propriétés. Pour les types qui alimentent un résultat enrichi, l’élément est comparé à une liste de propriétés requises et recommandées tirée de la documentation de Google.
4. Valeurs. Dans chaque élément, les adresses doivent être absolues, les dates et les durées doivent suivre la norme ISO 8601, @context doit être schema.org et chaque renvoi par @id doit mener quelque part.

Les microdonnées (itemscope, itemtype) et le RDFa (typeof) sont comptés et nommés par type. Leurs propriétés ne sont pas validées.

Les types que nous comparons et ce qu’ils demandent

Les autres types sont détaillés et leurs valeurs vérifiées, sans liste de propriétés requises.

Réparer ce que montre le rapport

Une erreur de syntaxe

Les blocs modifiés à la main se cassent sur les virgules et les guillemets. Générez le bloc avec un encodeur JSON (json_encode en PHP, JSON.stringify en JavaScript) et toute cette famille d’erreurs disparaît. Dans un CMS, collez le JSON-LD dans un champ de code. N’utilisez jamais l’éditeur visuel pour cela, car il transforme les guillemets en guillemets typographiques.

Une propriété requise manque

Ajoutez-la, avec la valeur qu’un visiteur peut voir sur la page. Les moteurs de recherche comparent les deux. Un balisage qui décrit quelque chose que la page ne montre pas peut valoir une action manuelle.

Une adresse relative

Écrivez https://www.example.com/img/cover.jpg en entier, pas /img/cover.jpg.

Une date qui n’est pas en ISO 8601

L’année d’abord, puis T, puis l’heure et le décalage par rapport à UTC : 2026-03-14T09:30:00+00:00. Un jour seul, 2026-03-14, est valide aussi.

Un renvoi vers nulle part

"author": {"@id": "…/#jane"} ne fonctionne que si un élément portant exactement cet @id se trouve sur la même page. Ajoutez l’élément, ou écrivez l’auteur directement à cet endroit.

Ce que cette vérification ne peut pas vous dire

Elle lit le HTML tel qu’il est livré. Les données structurées ajoutées ensuite par JavaScript ou par un gestionnaire de balises sont invisibles ici, même si Google peut les voir après le rendu. Les images ne sont pas téléchargées : une image cassée ou trop petite passe donc inaperçue. Les listes de propriétés couvrent les types de résultats courants. Elles ne couvrent pas tous les types ni tous les champs facultatifs.