What Is WebPage Schema? The Complete Guide (2026)

Why WebPage Schema Matters for SEO and AI Visibility

WebPage schema serves a different purpose from content schemas: it helps Google and AI systems build a machine-readable graph of your site's structure. When your WebPage schema correctly references your WebSite via isPartOf, and links to your primary content entity via mainEntity, you create a coherent knowledge graph that AI systems can traverse and cite.

Pages with well-structured entity graphs — WebSite → WebPage → Article/Product/etc. — give AI systems a coherent picture of your content, its context, and its authority. The WebPage schema is the glue that connects your page to the broader entity graph.

Valid WebPage Subtypes

Always use the most specific WebPage subtype that matches your content. Greadme recognizes the following valid subtypes:

Greadme Required Property

Schema.org does not define any required properties for WebPage. However, Greadme enforces one property as required because a WebPage schema without it is meaningless for entity graph linking:

Recommended Properties

WebPage Schema Code Example

A complete WebPage schema for an About page, with full graph linking:

{
  "@context": "https://schema.org",
  "@type": "AboutPage",
  "@id": "https://example.com/about#webpage",
  "url": "https://example.com/about",
  "name": "About Us | Acme Corp",
  "description": "Learn about Acme Corp, our mission, and our team.",
  "inLanguage": "en-US",
  "isPartOf": {
    "@id": "https://example.com#website"
  },
  "mainEntity": {
    "@id": "https://example.com#organization"
  },
  "primaryImageOfPage": {
    "@type": "ImageObject",
    "url": "https://example.com/about-hero.jpg"
  }
}

Building the Entity Graph: WebSite → WebPage → Content

The most powerful use of WebPage schema is as a node in an entity graph. A complete graph linking chain looks like this:

1. WebSite schema with @id: "https://example.com#website" — placed on the homepage, describes the overall site.
2. WebPage schema with @id: "https://example.com/page#webpage" and isPartOf: {"@id": "https://example.com#website"} — links this page to the site.
3. Content schema (Article, Product, etc.) with @id: "https://example.com/page#article" — linked from the WebPage via mainEntity.

When all three nodes are correctly linked via @id references, Google and AI systems can traverse the entire graph to understand context, authority, and content type simultaneously.

Common Mistakes to Avoid

• Missing url: Greadme treats this as an error (−20 pts). A WebPage schema without a valid url is effectively useless for entity graph linking.
• Using a relative URL: The url must be an absolute URL (starting with https://). Relative paths like /about cause an error.
• Missing isPartOf: Without this link, the WebPage exists in isolation and provides no graph value. Greadme warns and deducts 8 points.
• No mainEntity or about: Without linking to primary content, the WebPage schema describes a page but not what the page is about. Greadme warns and deducts 8 points.
• Using a generic WebPage when a subtype fits: If your About page uses "@type": "WebPage" instead of "AboutPage", Greadme warns with a recommendation to use the more specific subtype.

How Greadme Validates WebPage Schema

Greadme checks both required and recommended WebPage properties. The score starts at 100 with the following key deductions:

Frequently Asked Questions