JSON-LD

Mis à jour le 10 août 2026

Qu'est-ce que le JSON-LD ?

JSON-LD est le format recommandé par Google pour publier des données structurées : un bloc JSON isolé dans la page, qui décrit son contenu sans se mêler au HTML affiché.

Un bloc séparé du HTML

Contrairement aux microdata, qui parsèment les balises HTML d'attributs, JSON-LD vit dans un script isolé. Le balisage ne dépend donc plus de la structure visuelle : refondre la page ne casse pas les données déclarées.

C'est aussi ce qui le rend facile à générer côté serveur : les données existent déjà dans le code, on les sérialise dans le bon vocabulaire au moment du rendu.

Ce qui invalide un bloc

Un JSON mal formé : une virgule en trop suffit à faire ignorer tout le bloc.
Des propriétés obligatoires manquantes pour le type déclaré.
Des informations absentes du contenu visible de la page.
Des dates dans un format non conforme à la norme ISO 8601.

Exemple concret

Un outil de test rejette le type BlogPosting entier sur le blog d’un fabricant de capteurs industriels : les dates sont écrites en jour/mois/année et aucun auteur n’est déclaré. Les dates repartent en ISO 8601, l’auteur est renseigné depuis les données déjà présentes côté serveur. Le fil d’Ariane, lui, sort dans un second script plutôt que d’être imbriqué de force dans le premier.

À retenir

Plusieurs blocs JSON-LD peuvent coexister sur une page : un pour l'organisation, un pour le fil d'Ariane, un pour la FAQ. Les séparer rend chaque bloc lisible et facilite le diagnostic.

Questions fréquentes

Où placer le JSON-LD dans la page ?

Dans l'en-tête ou dans le corps, cela n'a pas d'importance pour Google. La constance compte davantage : même emplacement sur toutes les pages du site.

JSON-LD ou microdata ?

JSON-LD dans la quasi-totalité des cas : c'est le format recommandé, le plus simple à maintenir et le seul qui survit à une refonte du HTML.

Faut-il baliser toutes les pages ?

Au minimum l'organisation et le fil d'Ariane sur l'ensemble du site, puis les types spécifiques là où ils s'appliquent réellement.

Résumer cette définition avec :