GuidesRéférencement IA

Tuto : ajouter des données structurées (JSON‑LD) dans Astro

Par l’équipe Banzai LabsMis à jour le 2 min de lecture

<script type="application/ld+json">{ "@type": "Article", "headline": … }</script>ArticleAuteurDateUn composant Astro écrit le JSON-LD de chaque page
Le JSON-LD est écrit dans la page ; les moteurs y lisent le type, l’auteur et la date.

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

  1. 1Le code sourceLe bloc JSON-LD est présent et valide.
  2. 2Le test des résultats enrichisL’outil de Google signale les erreurs.
  3. 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.

À lire ensuite

Tous les guides