En bref. Un thème s’intègre à Yoast SEO en reliant les entités par leurs identifiants, en étendant son graphe avec les filtres de l’API Schema et en conciliant les données qui se recoupent.
Définition : Intégrer les données structurées produites par un thème à Yoast SEO consiste à relier ses descriptions d’entités, comme une organisation ou un livre, au graphe de données structurées de Yoast. L’intégration utilise les identifiants des entités et l’API Schema (Schema API) pour enrichir les données existantes ou ajouter des entités reliées au graphe.
Points clés
- En octobre 2026, les consignes d’intégration de Yoast recommandent d’adapter le balisage existant du thème à son approche par graphe et de désactiver la sortie distincte du thème lorsque Yoast gère le graphe complet.
- La spécification du schéma de Yoast décrit un graphe de base contenant
WebPage,WebSiteetOrganization, ouPersonpour un site personnel. - La documentation de l’API Schema de Yoast fournit
wpseo_schema_graph_piecespour ajouter ou supprimer des éléments du graphe etwpseo_schema_<class>pour modifier un élément existant.
Quelle structure l’intégration utilise-t-elle ?
Un graphe est un ensemble de descriptions d’entités reliées entre elles. Un nœud est la description d’une entité individuelle, et @id est son identifiant. JSON-LD est le format de données liées utilisé pour la sortie ; @graph contient les nœuds.
La spécification de Yoast attribue à chaque entité distincte un nœud de premier niveau et relie les nœuds par leurs identifiants. Son exemple de base relie le site à l’organisation qui le publie avec publisher, et la page au site avec isPartOf.
Cette structure donne à l’intégration du thème une tâche précise : identifier les entités déjà présentes et l’endroit où ajouter les informations supplémentaires. La spécification prévoit d’étendre le graphe de base selon l’entité principale de la page et ses attributs.
Comment le thème gère-t-il les données qui se recoupent ?
Les consignes d’intégration de Yoast prennent Organization comme exemple de doublon. Lorsque la description du thème est moins complète, elle peut devenir une référence au nœud de l’organisation de Yoast. Lorsqu’elle contient davantage d’informations, l’intégration peut appliquer un filtre à ce nœud Yoast pour y inclure les données supplémentaires.
Ces mêmes consignes autorisent des descriptions à partager un @id lorsque leurs valeurs ne se contredisent pas, afin que les logiciels qui les exploitent puissent les combiner. Avant l’intégration, les structures JSON-LD imbriquées ou les microdonnées existantes nécessitent une vérification des éventuelles informations contradictoires.
Quel code relie les entités du thème ?
La documentation de l’API Schema de Yoast décrit des éléments de graphe personnalisés qui étendent Abstract_Schema_Piece et reçoivent un objet Meta_Tags_Context contenant des variables de contexte. Le développeur enregistre les éléments supplémentaires au moyen de wpseo_schema_graph_pieces. Les modifications portant sur plusieurs nœuds utilisent wpseo_schema_graph.
Pour établir la liaison, les consignes d’intégration de Yoast distinguent un élément secondaire, relié par isPartOf, du sujet principal de la page, relié par mainEntityOfPage. L’extrait PHP suivant reprend l’exemple de l’entité principale :
$canonical = YoastSEO()->meta->for_current_page()->canonical;
$data['mainEntityOfPage'] = [ '@id' => $canonical ];
Ici, $data est le tableau de données structurées de l’entité. L’URL canonique identifie le nœud WebPage de Yoast. Le développeur du thème vérifie aussi si Yoast SEO est actif et gère en conséquence les données produites par le thème.
Comment examiner les données produites ?
La documentation de l’API Schema de Yoast fournit un filtre de développement qui met en forme les données structurées produites pour en faciliter la lecture :
add_filter( 'yoast_seo_development_mode', '__return_true' );
La documentation recommande de retirer ce réglage en production. Son exemple de suppression du fil d’Ariane supprime également la propriété breadcrumb de WebPage, ce qui illustre la nécessité de vérifier les références présentes ailleurs dans le graphe lors de la suppression d’un nœud.
Termes associés
Questions fréquentes
Faut-il désactiver toutes les données structurées de Yoast ?
La documentation de l’API Schema de Yoast fournit des filtres pour les éléments individuels et pour le graphe complet. Vous pouvez utiliser ces points d’intégration pour conserver et enrichir les données qu’il produit.
Que se passe-t-il si le site cesse d’utiliser Yoast SEO ?
Les consignes d’intégration indiquent qu’un thème peut construire son propre graphe en suivant la spécification de Yoast lorsque Yoast SEO est absent. Votre développeur doit prévoir ce cas dans la logique de production des données.
Sources
- Yoast, « Schema - Integration guidelines », sans date
- Yoast, « Schema - Specification », sans date
- Yoast, « Schema - API documentation », sans date
Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO