GuidesRéférencement IA
Tuto : ajouter des données structurées (JSON‑LD) dans Astro
1. Le composant
---
// src/components/JsonLd.astro
const { data } = Astro.props;
---
<script type="application/ld+json" set:html={JSON.stringify(data)} />
set:html évite qu’Astro échappe les guillemets du JSON.
2. Une page article
---
import JsonLd from '../components/JsonLd.astro';
const article = {
'@context': 'https://schema.org',
'@type': 'Article',
headline: 'Titre du guide',
datePublished: '2026-11-12',
author: { '@type': 'Organization', name: 'Votre société' },
};
---
<head>
<JsonLd data={article} />
</head>
3. Quel type, où
| Page | Type |
|---|---|
| Accueil | Organization ou LocalBusiness |
| Guide, article | Article |
| Fiche produit | Product, avec Offer |
| Toutes | BreadcrumbList |
| Questions-réponses | FAQPage |
4. Vérifier
- 1Le code sourceLe bloc JSON-LD est présent et valide.
- 2Le test des résultats enrichisL’outil de Google signale les erreurs.
- 3La Search ConsoleLe rapport des améliorations, après indexation.
Pourquoi c’est utile aux moteurs IA : Schema.org et moteurs IA.
Questions fréquentes
- Faut-il une bibliothèque ?
- Non. Un objet JavaScript et JSON.stringify suffisent. Une bibliothèque de types peut aider à éviter les fautes de propriété.
- Quels types mettre en priorité ?
- Organization (ou LocalBusiness) sur l’accueil, Article sur les contenus, Product sur les fiches produit, BreadcrumbList partout.
- Les données doivent-elles être visibles sur la page ?
- Oui. Le JSON-LD décrit ce que la page montre ; annoncer autre chose est contraire aux consignes de Google.