Le JSON-LD est un format informatique qui permet de décrire le contenu d'une page web, ou n'importe quel ensemble d'informations, sous une forme que les machines comprennent sans ambiguïté. Son nom est l'abréviation de JavaScript Object Notation for Linked Data, que l'on peut traduire par « notation objet issue de JavaScript pour les données liées ». Concrètement, il s'agit d'un petit bloc de texte, invisible pour le visiteur, que l'on glisse dans le code d'une page pour indiquer par exemple « ceci est une recette de tarte aux pommes, préparée en une heure, notée 4,5 sur 5 » ou « ceci est une entreprise, située à telle adresse, ouverte de 9 heures à 18 heures ». Les moteurs de recherche lisent ces données structurées pour mieux comprendre la page et, parfois, afficher dans leurs résultats des présentations enrichies : étoiles, temps de cuisson, prix, dates d'événements. Le JSON-LD repose sur le format JSON, lui-même dérivé de la syntaxe de JavaScript, et il est devenu une recommandation officielle du W3C, l'organisme qui définit les standards du web, en 2014. Cette définition explique ce qu'est le JSON-LD, d'où il vient, comment il est construit, à quoi il sert en référencement et au-delà, et comment l'intégrer à un site, exemples de code à l'appui.
Qu'est-ce que le JSON-LD ? Définition
Le JSON-LD est une manière d'écrire des données liées (Linked Data) en s'appuyant sur le format JSON. Pour comprendre ce que cela signifie, il faut partir du JSON classique : c'est un format texte très répandu qui organise l'information en paires « clé : valeur », comme "nom": "Jean Dupont", que l'on peut imbriquer les unes dans les autres. Il est simple à lire pour un humain et à traiter pour un programme, mais il a une faiblesse : la clé « nom » n'a de sens que pour celui qui l'a choisie. Un autre site pourrait écrire « name », « intitulé » ou « titre » pour dire la même chose, et une machine n'a aucun moyen de savoir qu'il s'agit de la même notion. Le JSON-LD règle ce problème en ajoutant quelques mots-clés réservés, qui commencent par le signe @. Le plus important, @context, indique à quel vocabulaire partagé se réfèrent les clés utilisées, le plus souvent celui de Schema.org. Le mot-clé @type précise la nature de la chose décrite (une personne, un produit, un article), et @id lui attribue un identifiant unique, généralement une adresse web, qui permet de la relier à d'autres données. Grâce à ces ajouts, chaque information acquiert une signification universelle : n'importe quel programme qui connaît le vocabulaire sait exactement de quoi il est question, ce qui est le principe même du web sémantique.
D'où vient le JSON-LD ? Origines et standardisation
L'histoire du JSON-LD commence avec celle du JSON, popularisé au début des années 2000 par le programmeur américain Douglas Crockford comme une alternative plus légère au XML pour échanger des données entre un serveur et un navigateur. Sa simplicité lui vaut un succès fulgurant, au point qu'il devient le format d'échange dominant des applications web et des interfaces de programmation. Parallèlement, le W3C promeut depuis la fin des années 1990 l'idée d'un web sémantique, imaginé notamment par Tim Berners-Lee, l'inventeur du web : un web dans lequel les données seraient décrites de façon suffisamment précise pour que les machines puissent les relier et raisonner dessus. Les formats proposés pour y parvenir, comme RDF/XML, se révèlent toutefois lourds et peu appréciés des développeurs. C'est pour combler ce fossé qu'un petit groupe, autour notamment de Manu Sporny, lance au début des années 2010 le projet JSON-LD : offrir la puissance des données liées dans une syntaxe que tout développeur web connaît déjà. Le format devient une recommandation du W3C en 2014, puis une version 1.1, enrichie, est publiée en 2020. Son adoption massive tient en grande partie aux moteurs de recherche, qui l'ont recommandé comme format privilégié pour leurs données structurées, aux côtés des anciens formats Microdata et RDFa.
Quelle est la structure du JSON-LD ? Exemples de code
Un bloc de JSON-LD se présente comme un objet JSON délimité par des accolades. Il commence presque toujours par le contexte, puis le type, puis les propriétés de l'élément décrit, qui doivent porter les noms exacts définis par le vocabulaire choisi. Avec Schema.org, une personne se décrit par le type Person et des propriétés comme name (nom) ou jobTitle (fonction), qui restent en anglais quelle que soit la langue du site : écrire « Personne » ou « métier » rendrait le bloc incompréhensible pour les machines, puisque ces termes n'existent pas dans le vocabulaire. La valeur d'une propriété peut être un simple texte, un nombre, une liste entre crochets ou un autre objet, lui-même typé, ce qui permet d'emboîter les informations : une recette a un auteur, qui est une personne ; un produit a une offre, qui a un prix et une devise. C'est cette imbrication qui fait du JSON-LD un véritable graphe de connaissances en miniature. Voici un exemple minimal décrivant une personne, puis la forme qu'il prend une fois placé dans une page web, entre des balises de script d'un type particulier, application/ld+json, qui indiquent au navigateur qu'il ne s'agit pas d'un programme à exécuter mais de données à lire. Ce code n'a aucun effet visuel : il est destiné aux robots d'indexation et aux autres programmes.
{
"@context": "https://schema.org",
"@type": "Person",
"name": "Jean Dupont",
"jobTitle": "Ingénieur"
}Pourquoi utiliser le JSON-LD ? Référencement et résultats enrichis
L'usage le plus répandu du JSON-LD concerne le référencement naturel, c'est-à-dire l'ensemble des techniques qui visent à améliorer la visibilité d'un site dans les moteurs de recherche. Un robot d'indexation lit très bien le texte d'une page, mais il doit deviner son organisation : ce nombre est-il un prix, une note ou un numéro de téléphone ? Les données structurées lui fournissent la réponse noir sur blanc. En retour, les moteurs peuvent afficher des résultats enrichis, ces présentations plus riches qu'un simple titre suivi d'une description : étoiles et nombre d'avis pour un produit, temps de préparation et photo pour une recette, dates et lieu d'un concert, fil d'Ariane indiquant la position d'une page dans le site. Plus visibles, ces résultats attirent souvent davantage de clics. Il faut toutefois garder des attentes réalistes. Le balisage ne garantit jamais l'affichage d'un résultat enrichi, qui reste à la discrétion du moteur, et les types de présentations proposés évoluent : certaines ont été restreintes ou supprimées au fil des années. Les données structurées ne sont pas non plus un facteur de classement magique ; elles aident surtout le moteur à comprendre et à présenter le contenu. Enfin, les informations balisées doivent correspondre exactement à ce que voit le visiteur : décrire des avis ou des prix absents de la page est contraire aux règles des moteurs et peut entraîner une pénalité.

Exemple : baliser une recette avec le JSON-LD
Prenons un site de cuisine qui publie une recette de tarte aux pommes et souhaite que les moteurs comprennent ses ingrédients, son temps de cuisson et son rendement. La démarche se fait en trois temps. Il faut d'abord choisir le bon type Schema.org, ici Recipe, puis consulter la documentation pour connaître les propriétés attendues et recommandées : name pour le titre, image pour la photo, recipeIngredient pour la liste des ingrédients, cookTime pour le temps de cuisson, exprimé selon la norme internationale ISO 8601 (PT1H signifie une heure), ou encore recipeYield pour le nombre de portions. Il faut ensuite rédiger le bloc en veillant à la syntaxe, car une simple virgule oubliée ou un guillemet mal fermé suffit à rendre l'ensemble illisible. Il reste enfin à placer le code dans la page, de préférence dans la section head du document HTML, même si les moteurs le lisent aussi lorsqu'il se trouve dans le corps. L'exemple ci-dessous montre un bloc simplifié ; dans la réalité, on y ajoute souvent les instructions détaillées étape par étape, la note moyenne des lecteurs ou les informations nutritionnelles, à condition qu'elles figurent aussi dans le contenu visible de la page.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Recipe",
"name": "Tarte aux pommes classique",
"author": { "@type": "Person", "name": "Jean Dupont" },
"image": "https://exemple.fr/images/tarte-pommes.jpg",
"description": "Une tarte aux pommes faite maison.",
"cookTime": "PT1H",
"recipeYield": "8 portions",
"recipeIngredient": ["1 pâte brisée", "6 pommes", "100 g de sucre", "1 cuillère à café de cannelle"],
"recipeInstructions": "Préchauffer le four à 180 °C, éplucher les pommes..."
}
</script>Le JSON-LD au-delà du SEO : échanges de données et web sémantique
Le JSON-LD ne sert pas qu'aux moteurs de recherche. Parce qu'il donne un sens partagé aux données, il facilite les échanges entre logiciels qui n'ont pas été conçus pour travailler ensemble. Une entreprise peut ainsi décrire une commande avec un vocabulaire commun (le type Order de Schema.org, avec son numéro, son statut, le produit commandé et le client) et transmettre ce même message à son logiciel de vente, à son outil de gestion des stocks et à son logiciel de relation client : chacun sait interpréter les champs, sans table de correspondance bricolée pour chaque connexion. Le format est aussi utilisé par des bibliothèques, des musées et des administrations qui publient des données ouvertes reliées entre elles, par des réseaux sociaux décentralisés qui s'appuient sur des standards du W3C pour faire dialoguer des serveurs indépendants, ou encore pour les attestations numériques vérifiables, comme des diplômes électroniques. Comparé au XML, longtemps roi des échanges de données, le JSON-LD est plus concis, plus facile à écrire et naturellement compris par les applications web modernes, tout en conservant la rigueur des identifiants universels. Il reste un JSON valide : un programme qui ignore tout du web sémantique peut le lire comme un JSON ordinaire, tandis qu'un outil spécialisé y verra un graphe de relations entre des choses identifiées de façon unique.
Comment intégrer le JSON-LD dans un site web ?
Plusieurs méthodes permettent d'ajouter du JSON-LD à un site, selon son outil de fabrication et le niveau d'aisance technique de son responsable. La plus directe consiste à écrire soi-même le bloc et à l'insérer dans le modèle de page HTML, entre des balises script de type application/ld+json ; c'est la solution la plus précise, idéale pour un site sur mesure. Sur un système de gestion de contenu comme WordPress, Joomla ou Drupal, des extensions de référencement génèrent automatiquement une bonne partie des données structurées (organisation, fil d'Ariane, articles, produits) à partir des informations déjà saisies, et proposent des réglages pour les compléter sans toucher au code. Les sites plus complexes produisent le JSON-LD dynamiquement à partir de leur base de données, ce qui garantit que les prix, les stocks ou les dates restent toujours à jour. Certains outils de gestion de balises permettent aussi de l'injecter, mais cette méthode est moins fiable car elle dépend de l'exécution de scripts dans le navigateur. Dans tous les cas, il faut tester le balisage avec les outils gratuits mis à disposition par les moteurs et par Schema.org, qui signalent les erreurs de syntaxe, les propriétés manquantes et l'éligibilité aux résultats enrichis, puis surveiller les rapports des consoles pour webmasters, qui alertent lorsqu'un problème apparaît après une modification du site.

| Format de données structurées | Où se place-t-il ? | Avantages | Inconvénients |
|---|---|---|---|
| JSON-LD | Bloc séparé, dans une balise script | Lisible, indépendant du HTML, facile à générer | Doit rester cohérent avec le contenu visible |
| Microdata | Attributs ajoutés aux balises HTML | Collé au contenu affiché | Alourdit le HTML, difficile à maintenir |
| RDFa | Attributs ajoutés aux balises HTML | Très expressif, issu du web sémantique | Syntaxe plus complexe pour les débutants |
| JSON classique | Échanges entre applications | Simple et universel | Pas de signification partagée des champs |
Les erreurs fréquentes à éviter
Quelques pièges reviennent souvent lorsqu'on se lance dans le JSON-LD. Le premier est la traduction des mots du vocabulaire : les types et les propriétés de Schema.org doivent être écrits exactement comme dans la documentation, en anglais et en respectant les majuscules, seules les valeurs (le nom d'une recette, une description) pouvant être en français. Le deuxième est la syntaxe : guillemets typographiques collés depuis un traitement de texte, virgule de trop après le dernier élément, accolade non refermée, autant d'erreurs qui rendent tout le bloc invalide. Le troisième est l'incohérence avec la page, par exemple une note de 4,8 dans les données alors qu'aucun avis n'est visible, ou un prix qui n'a pas été mis à jour ; les moteurs peuvent alors ignorer le balisage, voire sanctionner le site. Il faut aussi éviter les doublons, fréquents lorsque plusieurs extensions génèrent chacune leurs propres données sur un même site, et ne pas baliser des contenus qui ne s'y prêtent pas dans le seul espoir d'obtenir des étoiles. Enfin, le JSON-LD n'est qu'une aide à la compréhension : il ne remplace ni un contenu de qualité ni une bonne structure de page, et ce sont toujours ces deux éléments qui déterminent en priorité la place d'une page dans les résultats d'un moteur de recherche.