Vutral
Comment utiliser cet outil

Validateur de Schema Markup et Données JSON-LD

Comment utiliser le validateur de schema markup

Retour à l’outil

Une page entre ; chaque bloc JSON-LD de son HTML d’origine est analysé et confronté au vocabulaire Schema.org.

  1. 01

    Saisissez la page à vérifier

    Une page par exécution : les données structurées appartiennent à une page précise, et une pile d’arbres d’entités ne se lit pas côte à côte. Normaliser l’URL compte toujours : réglez sur Domaine uniquement et vous lirez le balisage de la page d’accueil, pas celui de la page collée.

  2. 02

    Lancez la vérification sur le HTML brut

    L’outil récupère la page et analyse le HTML qu’il reçoit. Il n’exécute pas JavaScript : le balisage injecté par un script après le chargement n’y est donc pas. C’est pourquoi un résultat vide dit « introuvable dans le HTML d’origine » et non « cette page n’a pas de schema ».

  3. 03

    Lisez l’impression JSON des données déclarées

    Le résultat est un document JSON aux lignes numérotées : les données structurées telles que lues, pas le balisage brut que vous avez écrit. Un élément référencé par @id est rempli là où il est utilisé. Une ligne à problème est teintée, avec une icône pour les erreurs et une autre pour les avertissements. Sous l’impression, une puce par type déclaré met en évidence chaque bloc de ce type.

  4. 04

    Suivez la liste jusqu’à la ligne exacte et exportez

    Sous l’impression figurent les deux compteurs et une entrée par problème, triées par numéro de ligne. Chaque entrée renvoie à sa propre ligne dans l’impression : une page à trente problèmes reste parcourable. Copier et Exporter, dans la ligne au-dessus de l’impression, vous remettent l’impression elle-même : le téléchargement est un fichier .json que vous pouvez recoller tel quel.

Comment lire le rapport de données structurées JSON-LD

La liste répond à deux questions : ce que cette page déclare, et quelles parties un parseur refuserait. Les champs obligatoires et l’éligibilité aux résultats enrichis ne sont pas jugés ici ; le moteur de recherche en décide pour chaque résultat enrichi.

Éléments de l’impression

@type
Le type Schema.org de l’élément, imprimé en première ligne, et la ligne où un type invalide est signalé. Un élément qui n’est qu’une référence n’a pas de ligne @type : la page n’en a déclaré aucun et l’impression n’invente rien.
@id
Ce qui distingue deux éléments du même type, imprimé juste après @type. Un élément référencé par @id est rempli là où il est utilisé, sans être répété au niveau supérieur, donc l’impression peut être plus courte que le balisage.
Erreurs
Du balisage qu’un analyseur refuserait ou ignorerait : un type ou une propriété absents du vocabulaire, une valeur du mauvais genre, un bloc qui n’est pas du JSON valide.
Avertissements
Du balisage valide qui n’est probablement pas ce que vous vouliez dire — le plus souvent une propriété qui existe mais n’est pas définie pour ce type. Schema.org parle d’attentes, pas de règles : ici, elles ne deviennent jamais des erreurs.

Référence des messages

Le type n’est pas dans le vocabulaire
Le @type n’existe pas dans Schema.org — le plus souvent une faute de frappe ou un nom inventé pour le site. Un élément sans aucun @type est signalé de la même façon, car un analyseur ne peut rien faire ni de l’un ni de l’autre.
La propriété n’est pas dans le vocabulaire
Ce nom de propriété n’existe nulle part dans Schema.org : personne ne peut donc la lire. C’est une erreur, la valeur est jetée quoi qu’elle dise.
La propriété n’est pas valide pour ce type
La propriété existe, mais pas sur ce type — cookTime sur un Article, par exemple. Simple avertissement : Schema.org traite le type d’appartenance d’une propriété comme une indication, et les consommateurs passent outre.
La valeur ne correspond pas au type attendu
La propriété existe et a sa place ici, mais la valeur est d’une autre nature — une simple chaîne là où une date ou un élément imbriqué était attendu.
Ce bloc n’est pas du JSON valide
Signalé au-dessus de la liste plutôt que dans un bloc, car un bloc qui ne s’analyse pas n’a aucun élément auquel rattacher quoi que ce soit. Tout ce qui suit l’erreur de syntaxe n’est pas lu ; une virgule égarée peut masquer le reste du balisage.
Pas de @context pointant vers schema.org
Signalé ici volontairement bien que le validateur de référence reste muet. Sans @context les noms à l’intérieur ne sont que des mots, donc rien dans le bloc n’a pu être vérifié, et un rapport propre sur un bloc non vérifié est la pire réponse possible.