Données structurées JSON-LD : le guide pratique pour le SEO et les moteurs IA
Le JSON-LD décrit à la machine ce que votre page montre déjà à l'humain. Bien fait, il rend une page éligible aux résultats enrichis et lève toute ambiguïté sur qui vous êtes ; mal fait, il ne sert à rien, ou pire. Voici la méthode, type par type.
En bref
Le JSON-LD est un bloc de script qui décrit le contenu visible d'une page avec le vocabulaire Schema.org. Google le recommande parmi les trois formats acceptés et s'en sert pour les résultats enrichis, sans jamais les garantir. Il n'est pas requis pour apparaître dans les fonctionnalités d'IA de Google, mais il rend votre entité explicite. Commencez par Organization, BreadcrumbList et Article, décrivez uniquement ce qui est visible, et validez chaque modèle avant de le déployer.
Sur cette page
- Qu'est-ce que le JSON-LD ?
- Ce qu'il fait, et ce qu'il ne fait pas
- Les règles à respecter
- Les types essentiels, avec exemples
- Organization sur l'accueil
- Article et BlogPosting sur les contenus
- BreadcrumbList sur les pages profondes
- Product, Service et LocalBusiness sur les offres
- Relier les entités avec @id et @graph
- FAQPage en 2026 : plus de résultat enrichi
- Valider votre balisage
- Les erreurs les plus fréquentes
- Comment NeoRank contrôle votre JSON-LD
- Questions fréquentes
Qu'est-ce que le JSON-LD ?
Les données structurées sont une façon standard de dire à un moteur ce que contient une page : une organisation, un article, un produit, un fil d'Ariane. Le vocabulaire commun s'appelle Schema.org ; il définit des types (Organization, BlogPosting…) et leurs propriétés (name, author, datePublished…).
Le JSON-LD est l'un des trois formats qui transportent ce vocabulaire, avec Microdata et RDFa. C'est un simple objet JSON placé dans une balise script de type application/ld+json, séparé du HTML affiché. Les consignes générales de Google acceptent les trois formats et recommandent le JSON-LD : il se maintient sans toucher au gabarit visuel et se génère facilement côté serveur.
Ce qu'il fait, et ce qu'il ne fait pas
Selon l'introduction de Google aux données structurées, le balisage aide Google à comprendre la page et peut la rendre éligible aux résultats enrichis : fil d'Ariane, informations d'article, logo, avis, etc. Éligible ne veut pas dire affiché. Google est explicite : un balisage correct ne garantit aucun affichage, l'algorithme choisit selon la requête, l'appareil et le contexte.
- Ce qu'il fait : il rend explicites l'entité (qui publie), le type de contenu, les dates, l'auteur et la hiérarchie du site. Un moteur n'a plus à le deviner.
- Ce qu'il ne fait pas : il ne fait pas monter une page dans le classement à lui seul. Une action manuelle pour données structurées abusives retire l'éligibilité aux résultats enrichis, sans toucher au classement de la page dans la recherche web.
- Et pour l'IA ? Le guide de Google sur les fonctionnalités d'IA générative indique qu'aucun balisage Schema.org particulier n'est requis pour y apparaître, tout en conseillant de continuer à utiliser les données structurées dans une stratégie SEO globale.
Pour les autres moteurs de réponse, le JSON-LD reste une déclaration d'identité lisible et non ambiguë. Il ne remplace pas le contenu : c'est ce que dit la page qui est repris dans les réponses. Notre article sur l'AEO détaille la place qu'il occupe parmi les autres leviers.
Les règles à respecter
Les consignes générales de Google tiennent en quelques principes, et les enfreindre peut rendre un balisage syntaxiquement parfait inutile, voire le faire traiter comme du spam :
- Décrire le contenu visible. Ne balisez pas une information que le lecteur ne voit pas, même si elle est exacte. Si le JSON-LD décrit un auteur, la page doit le nommer.
- Décrire la page où il se trouve. Le balisage d'un article va sur la page de l'article, pas sur l'accueil.
- Rester à jour. Une information périmée fait perdre l'éligibilité aux contenus sensibles au temps.
- Ne pas tromper. Pas de faux avis, pas d'usurpation d'organisation, pas de contenu sans rapport avec la page.
- Laisser Google y accéder. Une page bloquée par robots.txt ou par
noindexne transmet pas son balisage. - Écrire un JSON valide. Une virgule en trop ou un guillemet non fermé, et le bloc entier est ignoré.
Les types essentiels, avec exemples
Inutile de baliser tout Schema.org. Quatre familles couvrent l'essentiel d'un site vitrine, d'un média ou d'un SaaS.
Organization sur l'accueil
C'est la carte d'identité de votre marque : nom, URL, logo et profils officiels via sameAs. La documentation Organization de Google explique que ce balisage aide Google à comprendre les informations administratives de l'organisation et à choisir son logo. Le type complet est décrit sur schema.org/Organization.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"@id": "https://www.example.com/#organization",
"name": "Example Studio",
"url": "https://www.example.com/",
"logo": "https://www.example.com/logo-512.png",
"sameAs": [
"https://www.linkedin.com/company/example-studio",
"https://github.com/example-studio"
]
}
</script>Utilisez exactement le même nom de marque que dans vos titres, vos mentions légales et vos profils externes. Pour une entreprise avec une adresse physique, LocalBusiness (un sous-type d'Organization) permet d'ajouter l'adresse, les horaires et la zone desservie.
Article et BlogPosting sur les contenus
Sur un article, indiquez le titre, l'auteur, datePublished et dateModified. La documentation Article précise que ce balisage aide Google à mieux comprendre la page ; BlogPosting est le sous-type adapté à un billet de blog.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "How we cut our page weight in half",
"datePublished": "2026-09-01",
"dateModified": "2026-09-15",
"author": { "@type": "Organization", "name": "Example Studio", "url": "https://www.example.com/" },
"publisher": { "@id": "https://www.example.com/#organization" },
"mainEntityOfPage": "https://www.example.com/blog/page-weight"
}
</script>Ne changez dateModified que lorsque le contenu change réellement. Afficher une date de mise à jour sans modification, c'est précisément le genre de signal trompeur que les consignes proscrivent.
BreadcrumbList sur les pages profondes
Le fil d'Ariane décrit la position d'une page dans la hiérarchie du site. Il doit correspondre au fil visible sur la page (documentation Breadcrumb).
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com/" },
{ "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://www.example.com/blog" },
{ "@type": "ListItem", "position": 3, "name": "Page weight" }
]
}Product, Service et LocalBusiness sur les offres
Sur une page d'offre, Product ou Service décrit ce que vous vendez. N'ajoutez un prix, une disponibilité ou une note que s'ils sont affichés sur la page et exacts au moment de l'exploration.
Relier les entités avec @id et @graph
Quand plusieurs blocs décrivent la même organisation, donnez-lui un identifiant stable (@id, une URL avec fragment) et référencez-le au lieu de le répéter. Un @graph regroupe plusieurs nœuds dans un seul bloc. Résultat : l'éditeur d'un article, le propriétaire du site et l'organisation de l'accueil sont explicitement la même entité.
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://www.example.com/#organization",
"name": "Example Studio",
"url": "https://www.example.com/"
},
{
"@type": "WebSite",
"@id": "https://www.example.com/#website",
"url": "https://www.example.com/",
"name": "Example Studio",
"publisher": { "@id": "https://www.example.com/#organization" }
}
]
}FAQPage en 2026 : plus de résultat enrichi
La page des nouveautés de Google Search Central annonce que le résultat enrichi FAQ n'apparaît plus dans la recherche Google depuis le 7 mai 2026, et que sa documentation a été retirée. N'attendez donc plus de questions dépliables sous votre lien.
Le type FAQPage existe toujours dans le vocabulaire Schema.org. Il reste une description propre de questions et de réponses visibles sur la page, lisible par n'importe quelle machine. Gardez-le si vos pages ont une vraie FAQ ; ne créez pas de FAQ pour le balisage.
Valider votre balisage
- Test des résultats enrichis : le Rich Results Test indique les types que Google reconnaît sur une URL ou un extrait de code, et les erreurs qui bloquent l'éligibilité.
- Validateur Schema.org : le Schema Markup Validator vérifie la conformité au vocabulaire complet, y compris pour les types sans résultat enrichi chez Google.
- Inspection d'URL dans Search Console : elle montre le HTML que Googlebot a réellement reçu. Indispensable si votre JSON-LD est injecté par JavaScript.
- Surveillance : après le déploiement, les rapports d'amélioration de Search Console signalent les erreurs sur l'ensemble des pages concernées.
Les erreurs les plus fréquentes
| Erreur | Conséquence | Correction |
|---|---|---|
| JSON invalide (virgule finale, guillemet) | Bloc ignoré en entier | Générer le JSON côté serveur, jamais à la main |
| Contenu balisé absent de la page | Consignes non respectées | Baliser uniquement ce qui est affiché |
| Nom de marque différent d'une page à l'autre | Entité diluée | Un seul nom, un seul @id |
dateModified changée sans modification | Signal trompeur | Ne la changer qu'avec le contenu |
| Même balisage copié sur toutes les pages | Description fausse de chaque page | Un balisage par modèle de page |
Comment NeoRank contrôle votre JSON-LD
Le NeoRank Engine lit le JSON-LD de chaque page explorée. L'audit technique signale JSON_LD_INVALID quand un bloc ne se lit pas comme du JSON : c'est un contrôle de syntaxe, pas de conformité au vocabulaire Schema.org, d'où l'intérêt du validateur ci-dessus. La liste complète figure dans les contrôles de l'audit.
- Dans la visibilité IA, la tuile Schema.org compte les pages de la dernière exploration qui portent du JSON-LD, ainsi que les blocs invalides (tuiles « prêt pour l'IA »).
- Le rapport de page, dans les pages explorées, affiche le JSON-LD trouvé sur chaque URL.
- La page AEO de la documentation explique quels types privilégier pour les moteurs de réponse.
Questions fréquentes
- Le JSON-LD améliore-t-il directement le classement ?
- Non. Google l'utilise pour comprendre la page et la rendre éligible aux résultats enrichis. Une action manuelle retire cette éligibilité sans toucher au classement, ce qui montre bien qu'il ne s'agit pas d'un levier de classement direct.
- Faut-il un balisage spécial pour les fonctionnalités d'IA de Google ?
- Non. Le guide de Google sur les fonctionnalités d'IA générative indique qu'aucun balisage Schema.org particulier n'est nécessaire, tout en recommandant de continuer à utiliser les données structurées dans votre stratégie SEO.
- Dois-je supprimer mon balisage FAQPage ?
- Pas forcément. Google n'affiche plus le résultat enrichi FAQ depuis mai 2026, mais le type décrit toujours correctement une vraie FAQ visible. Supprimez-le seulement s'il décrit des questions qui ne figurent pas sur la page.
- JSON-LD, Microdata ou RDFa : lequel choisir ?
- Google accepte les trois et recommande le JSON-LD. Il est séparé du HTML affiché, plus simple à générer côté serveur et plus facile à relire, ce qui limite les erreurs de maintenance.
- Comment savoir si mes blocs JSON-LD sont valides sur tout le site ?
- Testez un modèle de page avec le Rich Results Test et le validateur Schema.org, puis surveillez l'ensemble du site : l'audit NeoRank signale chaque bloc qui ne se lit pas comme du JSON, page par page.
Pour aller plus loin, notre audit SEO technique en 15 contrôles replace le JSON-LD parmi les autres vérifications d'une page, et l'analyse gratuite montre où en est votre site.
Voyez où en est votre site
Lancez l'analyse gratuite pour voir ce que le NeoRank Engine relève sur votre site, JSON-LD compris.
Lancer l'analyse gratuiteSources
- Google Search Central — Introduction to structured data markup
- Google Search Central — General structured data guidelines
- Google Search Central — Article structured data
- Google Search Central — Organization structured data
- Google Search Central — Breadcrumb structured data
- Google Search Central — Latest documentation updates
- Google Search Central — Optimizing your website for generative AI features
- Schema.org — Getting started
- Schema.org — Organization
- Schema.org — BlogPosting
- Schema.org — FAQPage
- Schema Markup Validator
- Google Rich Results Test