JSON-LD

L'équipe Citead, mis à jour le

En bref. JSON-LD est un format fondé sur JSON pour les données liées (Linked Data), que les sites web peuvent intégrer dans un élément script pour décrire le contenu d’une page.

Définition : JSON-LD est un format fondé sur JSON qui permet d’exprimer des données liées (Linked Data) : des données lisibles par les machines et reliées entre documents et sites web. La spécification du W3C définit sa syntaxe, notamment les identifiants et le contexte qui donne un sens commun aux champs de données.

Points clés

À quoi ressemble JSON-LD dans une page ?

Les exemples HTML de la spécification du W3C intègrent JSON-LD dans un élément script de type application/ld+json. Le bloc suivant reproduit les données relatives à une personne tirées de son exemple décrivant Dave Longley :

<script type="application/ld+json">
{
  "@context": "http://schema.org/",
  "@id": "https://digitalbazaar.com/author/dlongley/",
  "@type": "Person",
  "name": "Dave Longley"
}
</script>

Le champ @context fournit le vocabulaire utilisé pour interpréter les noms courts. Ici, Person indique le type d’entité décrite et name fournit son nom. Le champ @id identifie la personne décrite au moyen d’un identifiant web. Ces rôles découlent des définitions du contexte, du type et des identifiants de nœuds dans la spécification.

Ce bloc illustre le format. Ses propriétés décrivent une personne ; une mise en œuvre sur un site web nécessite des propriétés adaptées au contenu représenté.

Quel est le lien entre JSON-LD et schema.org ?

Les données structurées constituent une manière normalisée de décrire et de classer le contenu d’une page. Dans l’exemple ci-dessus, JSON-LD fournit la syntaxe, tandis que schema.org fournit le vocabulaire utilisé pour décrire la personne.

L’introduction aux données structurées de Google explique que la plupart des données structurées de la recherche Google utilisent le vocabulaire schema.org. Google utilise ces informations pour comprendre le contenu des pages, notamment les informations sur les personnes ou les entreprises.

Pour une fonctionnalité précise de la recherche Google, la même documentation renvoie les responsables de la mise en œuvre aux propriétés obligatoires et recommandées par Search Central. Un résultat enrichi est un résultat de recherche dont la présentation comporte des éléments supplémentaires. L’éligibilité à cet affichage exige toutes les propriétés signalées comme obligatoires pour l’objet concerné.

Comment vérifier le balisage d’un site web ?

L’introduction aux données structurées de Google recommande le test des résultats enrichis (Rich Results Test) pendant le développement et les rapports sur l’état des résultats enrichis après le déploiement. Ces rapports aident à repérer les erreurs de balisage dues à des modifications des modèles de page ou de la diffusion des pages.

Les règles générales de Google exigent également une vérification du contenu. Si le balisage JSON-LD décrit un artiste, le HTML visible doit décrire ce même artiste. Les propriétés obligatoires doivent toutes être renseignées et les pages contenant le balisage doivent rester accessibles à Googlebot. Les règles précisent que les outils automatisés ne peuvent pas facilement vérifier le respect des consignes de qualité : le test technique doit donc s’accompagner de cette vérification éditoriale.

Termes associés

Questions fréquentes

Où puis-je placer JSON-LD dans une page HTML ?

La documentation de Google sur les formats prend en charge un élément script dans le head ou le body de la page. Le balisage peut être placé séparément du texte visible qu’il décrit.

Google peut-il lire du JSON-LD ajouté avec JavaScript ?

Oui. La même documentation sur les formats indique que Google peut lire du JSON-LD injecté dynamiquement par JavaScript ou par des widgets intégrés d’un système de gestion de contenu.

Ai-je besoin d’un balisage JSON-LD particulier pour les fonctionnalités de recherche par IA de Google ?

Les consignes de Google sur les fonctionnalités d’IA ne prévoient aucun balisage schema.org particulier pour AI Overviews ou AI Mode. Elles vous demandent de maintenir la cohérence entre les données structurées et le texte visible de la page.

Sources

  1. W3C, « JSON-LD 1.1 », 16 juillet 2020
  2. Google Search Central, « Introduction to structured data markup in Google Search », mise à jour le 10 décembre 2025
  3. Google Search Central, « General structured data guidelines », mise à jour le 10 juillet 2026
  4. Google Search Central, « AI features and your website », mise à jour le 10 décembre 2025

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Testez une page et voyez quoi corriger en premier

L'analyse prend en général moins de 10 secondes et ne demande pas de compte.

400 000+ pages notées dans le benchmark public