Comment ajouter du JSON-LD avec le module Schema.org Metatag de Drupal ?

L'équipe Citead, mis à jour le

En bref. Installez Schema.org Metatag et les sous-modules de schéma adaptés, configurez les valeurs par défaut des types de contenu avec des jetons de champs et validez le JSON-LD obtenu.

Définition : Schema.org Metatag étend le module Metatag de Drupal pour produire des données structurées, des informations exprimées sous forme de propriétés nommées, au format JSON-LD dans l’en-tête HTML d’une page. Les sous-modules de schéma fournissent les champs des propriétés ; les jetons de remplacement (tokens) récupèrent les valeurs du contenu du site pour renseigner ces champs.

Points clés

  • Au 17 octobre 2026, le projet Schema.org Metatag documente les valeurs par défaut des types de contenu et leur remplacement pour chaque contenu.
  • Le guide Drupal Basic Usage exige Metatag et recommande d’activer les sous-modules de schéma adaptés au contenu du site.
  • L’exemple Example Article setup associe headline à [node:title] et datePublished à [node:created:html_datetime].

Quels modules faut-il installer ?

Le guide Drupal CMS User Guide décrit l’installation de Schema Metatag, puis l’ouverture de Extend > List et le filtrage sur Schema.org. Les modules sélectionnés correspondent aux types de données structurées nécessaires au contenu du site. L’installation d’un module de schéma ajoute son groupe de champs au formulaire des valeurs par défaut de Metatag.

Le guide Basic Usage donne l’exemple d’un site d’actualités utilisant schema_metatag, schema_web_site et schema_article. La configuration commence par les paramètres globaux à l’adresse :

admin/config/search/metatag

Le guide place les paramètres WebSite au niveau global, puis ajoute les paramètres Article au type de contenu News. Cette organisation sépare les informations du site des propriétés d’un article donné. Sous Operations, Edit ouvre le formulaire des valeurs par défaut du type sélectionné, comme l’explique le guide Drupal CMS.

Comment associer les champs de contenu aux propriétés du schéma ?

Un jeton est une variable de remplacement dont la valeur provient du contenu ou des paramètres du site. L’exemple Drupal Example Article setup fournit les correspondances suivantes entre propriétés et jetons. Il s’agit des valeurs à saisir dans le formulaire, avec les paramètres de l’auteur imbriqués sous la propriété correspondante :

@type: NewsArticle
headline: [node:title]
name: [node:title]
description: [node:summary]
datePublished: [node:created:html_datetime]
dateModified: [node:changed:html_datetime]
mainEntityOfPage: [current-page:url]

AUTHOR
@type: Person
name: [node:author:display_name]
url: [node:author:url]

Le guide Help With Tokens and Fields explique que les jetons peuvent suivre des références vers des contenus liés. Son exemple d’image Media utilise :

[node:field_media_image:entity:field_media_image:large:url]

Ici, le premier champ appartient au contenu. entity suit la référence vers Media, le champ suivant désigne l’image et large sélectionne le style d’image. Le dernier élément, url, sélectionne l’URL de l’image. Les noms des champs et le style d’image doivent correspondre à la configuration du site. Le même guide précise que les URL des images doivent être absolues et que les jetons de largeur et de hauteur doivent utiliser le style d’image correspondant.

Comment vérifier les remplacements et le résultat produit ?

Le guide Basic Usage recommande des valeurs par défaut fondées sur des jetons qui réutilisent les informations déjà affichées sur la page. L’ajout d’un champ Metatag à un type de contenu permet de remplacer les valeurs pour chaque contenu ; le guide recommande de conserver autant que possible les valeurs par défaut définies pour l’ensemble du site.

La documentation du projet mentionne Schema Markup Validator et le test Google Rich Results Test comme outils de validation. Le module produit du JSON-LD dans l’en-tête HTML : la vérification de la page générée porte donc sur les valeurs obtenues après remplacement des jetons, notamment le titre de l’article, les dates et l’URL de l’image. Le guide Basic Usage recommande aussi de renouveler la validation de temps à autre et de surveiller les problèmes dans Google Search Console.

Termes associés

Questions fréquentes

Dois-je saisir manuellement les valeurs de chaque article ?

Le guide Basic Usage recommande d’utiliser des jetons dans les valeurs par défaut des types de contenu. Vous pouvez mettre à jour les champs du contenu sous-jacent, tandis que ces jetons fournissent les valeurs des données structurées.

Comment mettre en forme les dates de publication ?

Le guide des jetons documente [node:created:html_datetime] pour obtenir une date de création mise en forme. L’exemple Article associe ce jeton à datePublished et utilise [node:changed:html_datetime] pour dateModified.

Sources

  1. Drupal, « Schema.org Metatag », 19 février 2026, copie via l’API
  2. Drupal, « Basic Usage », 15 février 2021, copie via l’API
  3. Drupal, « Example Article setup », 26 mai 2020, copie via l’API
  4. Drupal, « Help With Tokens and Fields », 26 mai 2020, copie via l’API
  5. Drupal CMS User Guide, « Meta tags and Schema.org », consulté le 17 octobre 2026

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Testez une page et voyez quoi corriger en premier

L'analyse prend en général moins de 10 secondes et ne demande pas de compte.

400 000+ pages notées dans le benchmark public