4/11/2026
Les microdonnées (Microdata) décrivent le contenu d'une page directement dans ses balises HTML, à l'aide de quelques attributs. Ce format reste lu par Google et présent sur de nombreux thèmes de CMS, alors que JSON-LD est devenu la recommandation par défaut. Pour la vue d'ensemble (types, priorités, affichage dans Google), partez du guide complet des données structurées. Ici, on écrit du vrai balisage Microdata, on le compare à JSON-LD et à RDFa, puis on organise la migration.
Comprendre les microdonnées en HTML5
Les microdonnées font partie de la spécification HTML maintenue par le WHATWG. Elles servent à ajouter des métadonnées dans le contenu d'une page : on annote des éléments HTML existants pour qu'un robot puisse en extraire des paires nom / valeur, regroupées en objets (les items) et en propriétés.
L'information affichée et l'information balisée sont le même élément HTML : un prix visible dans un <span> devient la propriété price d'une offre grâce à un attribut. C'est la force du format, et aussi sa limite.
Le modèle itemscope / itemtype / itemprop
Trois attributs suffisent pour un premier balisage. Ils s'emboîtent toujours dans le même ordre :
itemscopeouvre un objet et fixe sa portée : tout ce qui est balisé à l'intérieur de l'élément lui appartient ;itemtypedit de quel type d'objet il s'agit, sous la forme d'une URL de vocabulaire, par exempleitemtype="https://schema.org/Product";itemproprattache un élément descendant à une propriété de cet objet :name,image,offers…
Un itemprop peut lui-même porter un itemscope : on obtient alors un objet imbriqué, comme une offre (Offer) à l'intérieur d'un produit. La logique type → propriétés → valeurs est identique dans les trois formats ; seul l'endroit où l'on écrit le balisage change.
Schema.org, un vocabulaire ouvert et pas un format
Microdata est une syntaxe ; il lui faut un vocabulaire pour nommer les types et les propriétés. En SEO, ce vocabulaire est schema.org, lancé en 2011 par Google, Microsoft et Yahoo, rejoints par Yandex, et maintenu par une communauté rattachée au W3C. Il n'appartient à aucun moteur : le même Product est compris par Google, Bing, les aperçus de liens et les robots des moteurs génératifs.
Les attributs Microdata : rôle et exemple
Le tableau suivant récapitule les cinq attributs de la spécification, avec la forme qu'ils prennent dans un balisage schema.org :
| Attribut | Rôle | Exemple |
|---|---|---|
itemscope | Crée un objet ; ses descendants balisés deviennent ses propriétés | <div itemscope itemtype="https://schema.org/Product"> |
itemtype | Indique le type de l'objet par une URL du vocabulaire | itemtype="https://schema.org/Offer" |
itemprop | Associe la valeur d'un élément à une propriété de l'objet | <h1 itemprop="name">Capteur TX-200</h1> |
itemid | Donne un identifiant global et stable à l'objet, l'équivalent de @id en JSON-LD | itemid="https://www.exemple.fr/tx-200#product" |
itemref | Rattache à l'objet des propriétés placées ailleurs dans la page, par leur attribut id | itemref="fiche-prix" |
La valeur d'une propriété dépend de l'élément qui porte le itemprop : le texte pour un <span> ou un <h1>, l'attribut src pour une <img>, l'attribut href pour un <a> ou un <link>, l'attribut content pour un <meta>.
Valeurs non affichées telles quelles : meta et link
Certaines valeurs sont visibles sur la page sous une forme que les robots lisent mal : le symbole € plutôt que le code de devise, la mention « En stock » plutôt qu'une URL de statut. Microdata prévoit deux éléments pour exprimer la forme normalisée sans rien afficher de plus :
<meta itemprop="priceCurrency" content="EUR">pour une valeur textuelle, ici le code ISO de la devise ;<link itemprop="availability" href="https://schema.org/InStock">pour une valeur qui est une URL, ici le statut de disponibilité ;- l'attribut
contentsur un élément visible, par exemple<span itemprop="price" content="149.00">149,00</span>, pour donner un nombre au format attendu.
Ces éléments traduisent une information déjà présente à l'écran ; ils ne servent jamais à ajouter un prix, un avis ou une disponibilité que le visiteur ne voit pas. Baliser ce qui n'est pas visible fait perdre l'éligibilité et expose à une action manuelle pour données structurées trompeuses.
Exemple complet : une fiche Product + Offer en Microdata, puis en JSON-LD
Prenons la fiche d'un capteur industriel : nom, image, description, marque, prix hors taxe et disponibilité. Le même contenu est balisé deux fois, pour comparer les formats ligne à ligne.
Le produit balisé en Microdata
Dans cet exemple, chaque attribut se pose sur l'élément qui affiche déjà l'information ; l'offre est un objet imbriqué, et la devise comme la disponibilité passent par <meta> et <link> :
<div itemscope itemtype="https://schema.org/Product" itemid="https://www.exemple.fr/tx-200#product"><h1 itemprop="name">Capteur de température TX-200</h1><img itemprop="image" src="https://www.exemple.fr/img/tx-200.jpg" alt="Capteur TX-200"><p itemprop="description">Capteur connecté pour lignes de production.</p><p>Marque : <span itemprop="brand" itemscope itemtype="https://schema.org/Brand"><span itemprop="name">Exemple Industrie</span></span></p><div itemprop="offers" itemscope itemtype="https://schema.org/Offer"><span itemprop="price" content="149.00">149,00</span> € HT<meta itemprop="priceCurrency" content="EUR"><link itemprop="availability" href="https://schema.org/InStock"><span>En stock</span><link itemprop="url" href="https://www.exemple.fr/tx-200"></div></div>
Trois points méritent l'attention. Le prix porte un content avec un point décimal, car l'affichage français utilise la virgule. La marque est un objet Brand imbriqué, pas une simple chaîne. Enfin, le itemid donne au produit un identifiant stable, réutilisable ailleurs.
Le même produit en JSON-LD
Voici exactement les mêmes informations exprimées en JSON-LD, dans un bloc séparé du HTML d'affichage :
<script type="application/ld+json">{"@context": "https://schema.org","@type": "Product","@id": "https://www.exemple.fr/tx-200#product","name": "Capteur de température TX-200","image": "https://www.exemple.fr/img/tx-200.jpg","description": "Capteur connecté pour lignes de production.","brand": { "@type": "Brand", "name": "Exemple Industrie" },"offers": {"@type": "Offer","price": "149.00","priceCurrency": "EUR","availability": "https://schema.org/InStock","url": "https://www.exemple.fr/tx-200"}}</script>
Les deux versions déclarent le même graphe : un Product, une Brand, une Offer, avec des propriétés identiques. La différence est d'emplacement. En Microdata, le balisage suit la structure du HTML et casse si un composant change ; en JSON-LD, il se génère à part depuis les champs du CMS, mais il faut veiller à ce que le prix balisé reste celui qui est affiché.
Fil d'Ariane et itemref : deux cas courants
Deux situations reviennent sur presque tous les sites balisés en Microdata : le fil d'Ariane généré par le thème, et un objet dont les informations sont dispersées dans la page.
Baliser un fil d'Ariane avec BreadcrumbList
Le fil d'Ariane est une liste ordonnée : chaque niveau est un ListItem avec un nom, un lien et une position. Le dernier niveau, la page courante, peut se passer de lien :
<ol itemscope itemtype="https://schema.org/BreadcrumbList"><li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><a itemprop="item" href="https://www.exemple.fr/capteurs"><span itemprop="name">Capteurs</span></a><meta itemprop="position" content="1"></li><li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><a itemprop="item" href="https://www.exemple.fr/capteurs/temperature"><span itemprop="name">Température</span></a><meta itemprop="position" content="2"></li><li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><span itemprop="name">Capteur TX-200</span><meta itemprop="position" content="3"></li></ol>
À la date de rédaction, Google n'affiche plus le fil d'Ariane sur mobile depuis début 2025 ; il reste affiché sur desktop et utile pour décrire la hiérarchie du site. La position passe par un <meta>, car le numéro n'est pas affiché : il découle de l'ordre visible des liens.
Rattacher des propriétés éloignées avec itemref
Quand le prix est affiché dans un encart hors du bloc produit (une colonne latérale, un bandeau d'achat), itemref rattache cet encart au produit par son id, sans réorganiser le HTML. L'exemple suivant montre ce rattachement :
<div itemscope itemtype="https://schema.org/Product" itemref="fiche-prix"><h1 itemprop="name">Capteur de température TX-200</h1><p itemprop="description">Capteur connecté pour lignes de production.</p></div><!-- autres blocs de la page --><div id="fiche-prix" itemprop="offers" itemscope itemtype="https://schema.org/Offer"><span itemprop="price" content="149.00">149,00</span> € HT<meta itemprop="priceCurrency" content="EUR"><link itemprop="availability" href="https://schema.org/InStock"></div>
L'attribut est pratique mais fragile : si un développeur renomme l'id ou duplique l'encart, l'offre se détache du produit sans erreur visible à l'écran. Réservez-le aux gabarits stables, et retestez-le après chaque modification du thème.
Structured data formats : comparer JSON-LD, microdata et RDFa
Les trois formats expriment le même vocabulaire schema.org, et Google lit les trois. Ce qui les distingue relève de l'exploitation : où s'écrit le balisage, qui le maintient, et ce qui peut le désynchroniser du contenu. Le tableau suivant les compare sur ces critères :
| Critère | JSON-LD | Microdata | RDFa |
|---|---|---|---|
| Où s'écrit le balisage | Bloc <script type="application/ld+json"> dans le <head> ou le <body> | Attributs itemscope, itemtype, itemprop sur les éléments visibles | Attributs vocab, typeof, property sur les éléments visibles |
| Maintenance | Séparée du HTML, générée par gabarit depuis les champs du CMS | Liée aux composants : chaque refonte front peut casser une propriété | Liée aux composants, syntaxe plus riche et plus exigeante |
| Risque de désynchronisation | Écart possible entre le bloc et la page (prix, stock) si les deux ne lisent pas le même champ | Faible sur les valeurs affichées, élevé sur la structure (imbrication, itemref) | Comparable à Microdata |
| Position de Google (à la date de rédaction) | Format recommandé | Lu et pris en charge | Lu et pris en charge |
| Cas d'usage | Nouveaux gabarits, sites à fort volume, équipes multiples, refontes fréquentes | Thème existant déjà balisé, composants stables | Organisations déjà structurées autour du web sémantique et des vocabulaires RDF |
Google recommande JSON-LD pour une raison industrielle : séparer la couche de données de la couche d'affichage limite les effets de bord quand l'interface évolue, et rend le balisage testable comme n'importe quel autre code. Microdata n'est pas pénalisé pour autant ; il coûte simplement plus cher à maintenir sur un site qui bouge.
RDFa : quand il se justifie
RDFa (Resource Description Framework in Attributes) annote lui aussi le HTML, avec une logique issue du web sémantique. Pris en charge par Google, il est plus rare en SEO et plus délicat à écrire. Il se justifie surtout là où l'on publie déjà des vocabulaires RDF, avec des compétences dédiées.
Quand Microdata reste pertinent, et ce qu'il faut surveiller
Sur un site stable et déjà balisé, corriger les microdonnées coûte souvent moins cher que les remplacer.
Les cas où le format garde sa place
Trois situations justifient de conserver des microdonnées, au moins à court terme :
- un thème existant qui en génère : de nombreux thèmes e-commerce et de blog posent des attributs
itempropdans leurs gabarits ; tant que le thème ne change pas, la priorité est la correction, pas la migration ; - la proximité avec le contenu affiché : la valeur balisée est l'élément rendu, ce qui limite les écarts entre prix balisé et prix affiché sur les fiches à tarifs variables ;
- des composants autonomes : un composant d'avis ou de fiche technique qui porte son propre balisage reste cohérent partout où il est inséré, à condition que ses attributs soient documentés.
Les risques à contrôler
Les problèmes de Microdata viennent rarement de la syntaxe ; ils naissent dans les gabarits et les ajouts successifs :
- migration partielle : un bloc JSON-LD ajouté sans retirer les attributs existants décrit le même produit deux fois, parfois avec deux prix ;
- doublons plugin CMS + gabarit : un plugin CMS génère du JSON-LD pendant que le thème conserve ses microdonnées, et personne ne sait lequel fait foi ;
- imbrications cassées : un
itemscopedéplacé par une refonte rattache une propriété au mauvais objet ; - itemref orphelins : un
idrenommé détache une offre de son produit ; - valeurs non visibles : un
<meta>utilisé pour déclarer une note ou un prix absents de la page.
Migrer de Microdata vers JSON-LD
Une migration réussie remplace un format par un autre sans jamais laisser deux descriptions concurrentes en ligne plus de quelques jours. Elle se mène gabarit par gabarit, en cinq étapes :
| Étape | Action | Contrôle |
|---|---|---|
| 1. Inventaire | Lister les gabarits qui portent des attributs itemscope (thème, composants, plugins) et les types déclarés | Une page de référence par gabarit, avec son balisage actuel extrait |
| 2. Génération par gabarit | Écrire le bloc JSON-LD à partir des mêmes champs CMS que l'affichage, avec les mêmes types et des @id stables | Le JSON-LD de chaque page de référence décrit les mêmes valeurs que la page |
| 3. Cohabitation courte | Publier le JSON-LD pendant que les microdonnées sont encore en place, le temps de comparer | Mêmes types et mêmes valeurs dans les deux formats ; durée limitée à quelques jours |
| 4. Retrait | Supprimer les attributs Microdata du thème et désactiver les sorties concurrentes des plugins | Plus aucun itemscope dans le HTML rendu des pages de référence |
| 5. Test | Tester les pages de référence, puis suivre les rapports par type sur l'ensemble du site | Aucune nouvelle erreur, nombre d'éléments valides stable |
Commencez par les gabarits qui portent un résultat enrichi actif, comme les fiches produit, et gardez pour la fin ceux qui ne servent qu'à la compréhension.
Vérifier le balisage après la migration
Testez toujours le HTML réellement rendu, pas le gabarit théorique : en Microdata, le balisage dépend du DOM final, et un composant chargé en JavaScript peut le modifier. Le Rich Results Test contrôle l'éligibilité aux résultats enrichis, le validateur Schema.org la conformité au vocabulaire. La méthode pas à pas est détaillée dans notre guide pour tester vos données structurées avec le Rich Results Test.
Sur la durée, les rapports « Améliorations » de Google Search Console montrent, type par type, les pages valides, valides avec avertissements et invalides. Une hausse des pages invalides après le retrait des microdonnées signale en général un gabarit oublié.
Quel que soit le format, le balisage aide aussi les robots des moteurs génératifs à lire la page : quelle entité, quel prix, quelle organisation. Aucun effet direct sur le fait d'être cité n'est démontré ; l'enjeu est une restitution exacte. Pour aller plus loin, voyez ce que les données structurées apportent aux moteurs génératifs.
Selon votre situation
Selon votre point de départ, ces ressources prolongent ce guide :
- vous cherchez des exemples prêts à adapter pour Article, Organization ou LocalBusiness : consultez la bibliothèque d'exemples JSON-LD par type schema.org ;
- votre balisage diffère d'un gabarit à l'autre ou a cassé après une refonte : commencez par un audit SEO technique de vos gabarits ;
- votre thème génère des microdonnées et un plugin CMS ajoute du JSON-LD : choisissez une seule source de vérité avant toute autre correction.
Pour détecter les erreurs de balisage sur l'ensemble de vos pages, y compris les doublons laissés par une migration, le module Audit GEO/SEO 360 d'Incremys, plateforme GEO & SEO, regroupe les pages fautives par gabarit et suit votre présence IA par mot-clé.
FAQ : format microdata, données structurées et structured data formats
Que sont les microdonnées ?
Les microdonnées sont des attributs HTML (itemscope, itemtype, itemprop) ajoutés aux balises d'une page pour décrire ses entités et leurs propriétés selon un vocabulaire, en général schema.org. Elles rendent explicites, pour les moteurs et les autres robots, des informations comme un nom de produit, un prix, une disponibilité ou un fil d'Ariane, directement sur les éléments affichés.
Microdata ou JSON-LD : lequel choisir ?
Choisissez JSON-LD pour tout nouveau gabarit : c'est le format recommandé par Google, séparé du HTML et simple à générer depuis le CMS. Gardez Microdata seulement sur un site déjà balisé ainsi, aux composants stables, en attendant une refonte. Les deux formats décrivent les mêmes types et donnent accès aux mêmes résultats enrichis.
Comment savoir si mon thème CMS génère déjà des microdonnées ?
Affichez le code source d'une page type et cherchez l'attribut itemscope ; sa présence signale des microdonnées. Pour une vue complète, testez la même URL dans le Rich Results Test ou le validateur Schema.org : ils listent chaque objet détecté. Faites-le par gabarit, car fiches produit, articles et pages catégorie utilisent souvent des fichiers différents.
Comment migrer de Microdata vers JSON-LD ?
Procédez gabarit par gabarit : inventoriez les microdonnées existantes, générez le JSON-LD depuis les mêmes champs CMS, laissez cohabiter les deux formats quelques jours pour comparer, retirez les attributs du thème, puis testez. Le point critique est le retrait : un JSON-LD ajouté sans supprimer l'ancien balisage crée des doublons.
Peut-on mélanger Microdata et JSON-LD sur une même page ?
Oui, Google lit les deux formats sur une même page. Le risque apparaît quand ils décrivent la même entité avec des valeurs différentes, par exemple deux prix pour un produit. Si vous mélangez, réservez chaque format à des entités distinctes, ou reliez-les par le même identifiant (itemid et @id), et ne gardez jamais deux descriptions concurrentes.
Comment baliser une valeur non affichée (devise, disponibilité) ?
Utilisez meta itemprop avec l'attribut content pour une valeur textuelle, comme le code EUR, et link itemprop avec href pour une URL, comme https://schema.org/InStock. Ces éléments donnent la forme normalisée d'une information visible sous une autre forme (symbole €, mention « En stock »). Ils ne doivent jamais déclarer une information absente de la page.
À quoi sert itemref ?
L'attribut itemref rattache à un objet des propriétés placées hors de son élément, en citant leur attribut id. Il évite de restructurer le HTML quand le prix ou la fiche technique s'affiche dans un encart séparé. Il reste fragile : un id renommé ou dupliqué détache la propriété sans erreur visible, d'où un test après chaque modification du thème.

%2520-%2520blue.jpeg)

.jpeg)
.jpeg)
.avif)