@type / @context

Clés JSON-LD déclarant le vocabulaire et le type de l'entité décrite.

@context et @type sont les deux clés fondatrices d'un objet JSON-LD. @context désigne le vocabulaire employé — en pratique https://schema.org — et @type nomme le type de l'entité décrite : Article, Product, Organization, etc. Ensemble, elles disent au moteur selon quel dictionnaire lire cet objet, et de quoi il parle.

Leur importance est disproportionnée par rapport à leur taille. Un @context manquant ou erroné rend l'objet ininterprétable ; un @type inexact — un produit balisé en article — fait lire les bonnes propriétés dans le mauvais cadre, ce qui invalide l'ensemble. En agence, ce sont les deux premières lignes qu'on vérifie dans toute revue de balisage.

Le bon @type est aussi ce qui rattache le contenu à une entité nommée du vocabulaire Schema.org : choisir le type le plus spécifique et exact conditionne toute la suite. En pratique, on contrôle la présence de ces deux clés, l'orthographe exacte des valeurs et l'adéquation du type à la réalité de la page avant même de regarder les autres propriétés.