Guides

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.

  • JSON-LD
  • Schema.org
  • structured data
  • rich results

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
  1. Qu'est-ce que le JSON-LD ?
  2. Ce qu'il fait, et ce qu'il ne fait pas
  3. Les règles à respecter
  4. Les types essentiels, avec exemples
  5. Organization sur l'accueil
  6. Article et BlogPosting sur les contenus
  7. BreadcrumbList sur les pages profondes
  8. Product, Service et LocalBusiness sur les offres
  9. Relier les entités avec @id et @graph
  10. FAQPage en 2026 : plus de résultat enrichi
  11. Valider votre balisage
  12. Les erreurs les plus fréquentes
  13. Comment NeoRank contrôle votre JSON-LD
  14. 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 :

  1. 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.
  2. Décrire la page où il se trouve. Le balisage d'un article va sur la page de l'article, pas sur l'accueil.
  3. Rester à jour. Une information périmée fait perdre l'éligibilité aux contenus sensibles au temps.
  4. Ne pas tromper. Pas de faux avis, pas d'usurpation d'organisation, pas de contenu sans rapport avec la page.
  5. Laisser Google y accéder. Une page bloquée par robots.txt ou par noindex ne transmet pas son balisage.
  6. É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.

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

  1. 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é.
  2. 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.
  3. 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.
  4. 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

ErreurConséquenceCorrection
JSON invalide (virgule finale, guillemet)Bloc ignoré en entierGénérer le JSON côté serveur, jamais à la main
Contenu balisé absent de la pageConsignes non respectéesBaliser uniquement ce qui est affiché
Nom de marque différent d'une page à l'autreEntité diluéeUn seul nom, un seul @id
dateModified changée sans modificationSignal trompeurNe la changer qu'avec le contenu
Même balisage copié sur toutes les pagesDescription fausse de chaque pageUn 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 gratuite

Sources

  1. Google Search Central — Introduction to structured data markup
  2. Google Search Central — General structured data guidelines
  3. Google Search Central — Article structured data
  4. Google Search Central — Organization structured data
  5. Google Search Central — Breadcrumb structured data
  6. Google Search Central — Latest documentation updates
  7. Google Search Central — Optimizing your website for generative AI features
  8. Schema.org — Getting started
  9. Schema.org — Organization
  10. Schema.org — BlogPosting
  11. Schema.org — FAQPage
  12. Schema Markup Validator
  13. Google Rich Results Test

Partager