En bref. Les données structurées WebPage décrivent une page web et peuvent la relier à son entité principale et au WebSite auquel elle appartient.

Définition : Schema.org définit WebPage comme une page web. Les données structurées WebPage décrivent cette page et peuvent exprimer sa relation avec son sujet principal et avec le site web auquel elle appartient.

Points clés

La définition de WebPage de Schema.org recommande de déclarer explicitement le type lorsque des propriétés de la page telles que breadcrumb sont renseignées.
La propriété mainEntity de Schema.org identifie l’entité principale décrite par une page ou une autre œuvre de création.
La propriété mainEntityOfPage de Schema.org exprime la relation inverse, de cette entité vers la page qui la décrit.
La propriété isPartOf de Schema.org relie une œuvre de création à un élément ou à une œuvre dont elle fait partie ; sa propriété inverse est hasPart.

Qu’est-ce qui identifie la page ?

JSON-LD est un format JSON pour les données liées. Un nœud est un élément identifiable dans ces données. La spécification JSON-LD du W3C utilise @id pour identifier un nœud et @type pour indiquer son type. Un objet WebPage peut donc posséder son propre identifiant en plus de "@type": "WebPage".

Schema.org définit url comme l’URL de l’élément. Ces champs remplissent des rôles différents : @id identifie le nœud dans les données liées, tandis que url fournit une URL associée à l’élément décrit. L’exemple de café de Schema.org utilise l’URL d’une page comme identifiant de l’objet WebPage et imbrique un objet Restaurant distinct sous mainEntity.

Comment une page est-elle reliée à son sujet et à son site web ?

Une entité est la chose décrite, par exemple un restaurant. L’exemple de mainEntity de Schema.org décrit un objet WebPage dont l’entité principale est un Restaurant nommé Cath's Cafe. L’exemple attribue à la page son propre type et place le nom du restaurant et les informations sur l’établissement dans l’objet Restaurant.

La relation inverse utilise mainEntityOfPage : l’entité pointe vers une page dont elle est le sujet principal. La valeur attendue est une œuvre de création ou une URL.

Un WebSite représente un ensemble de pages et d’autres éléments liés entre eux, généralement servis depuis un même domaine. Appliquer isPartOf à l’objet WebPage exprime son appartenance à ce site web. Cette relation indique à quel ensemble appartient la page ; mainEntity indique ce qu’elle décrit principalement.

À quoi ressemble le balisage ?

Cette adaptation illustrative de l’exemple Cath's Cafe de Schema.org conserve l’identifiant de la page et son sujet principal, omet les informations sur l’établissement et ajoute un WebSite auquel la page appartient à l’aide de isPartOf. Les données servent d’exemple.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "@id": "http://cathscafe.example.com/",
  "url": "http://cathscafe.example.com/",
  "isPartOf": {
    "@type": "WebSite",
    "@id": "http://cathscafe.example.com/#website"
  },
  "mainEntity": {
    "@type": "Restaurant",
    "name": "Cath's Cafe"
  }
}
</script>

Les instructions d’intégration du W3C placent le JSON-LD dans un élément HTML script avec type="application/ld+json". Ici, le Restaurant est le sujet principal de la page et le WebSite est l’ensemble auquel elle appartient.

Comment vérifier le balisage WebPage ?

Au 17 octobre 2026, les consignes de Google sur les tests de données structurées orientent la validation générique de Schema.org vers le Schema Markup Validator. Cet outil teste le balisage Schema.org intégré aux pages sans avertissements propres aux fonctionnalités de Google. Les mêmes consignes indiquent d’utiliser le test des résultats enrichis (Rich Results Test) pour vérifier quels résultats enrichis Google le balisage peut produire.

Termes associés

Questions fréquentes

mainContentOfPage identifie-t-il le même type de chose que mainEntity ?

Le tableau des propriétés de WebPage de Schema.org attend un WebPageElement pour mainContentOfPage, ce qui désigne un élément de la page comme sujet principal. mainEntity peut pointer vers un Thing, y compris le Restaurant de l’exemple de Schema.org.

Puis-je décrire la relation depuis le sujet ?

Oui. Vous pouvez utiliser mainEntityOfPage sur le sujet, avec pour valeur la page qui le décrit. L’exemple Restaurant de Schema.org utilise l’URL de la page du café pour cette propriété.

Sources

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

Données structurées WebPage