What are the key properties for Webpage schema?

Essential properties vary by schema type but commonly include name, description, url, and image. For rich results, specific properties like author, datePublished, or offers may be required.

How does Webpage schema affect SEO?

Webpage schema enables rich results in Google Search, increases click-through rates with enhanced listings, improves content visibility, and provides structured data that helps search engines better understand and display your content.

What are the benefits of Webpage structured data?

Benefits include enhanced search appearances, improved click-through rates, better content understanding by search engines, and eligibility for rich result features like carousels, panels, or enhanced listings.

How to Validate WebPage Schema

Everything you need to know about WebPage schema markup. Learn how to describe individual pages on your website for better search engine understanding and enhanced results.

What is WebPage Schema?

WebPage schema describes individual pages on your website. While WebSite schema gives the big picture of your entire domain, WebPage schema zooms in on specific pages, telling search engines what each page is about and how it fits into your site structure.

Why WebPage Schema Matters

Most websites implement content-specific schemas (Article, Product, etc.) but forget the foundational WebPage markup. WebPage schema provides essential page-level context that helps search engines understand your content better.

The key insight: WebPage schema is the bridge between your site's overall structure (WebSite) and specific content (Article, Product, etc.). It provides the page-level context that makes your other schemas more effective.

What WebPage Schema Includes

•Basic page info: title, description, URL

•Content relationships: main entity, navigation

•Page type classification: about, contact, FAQ

•Site navigation: breadcrumbs, related pages

SEO Benefits You Get

📄Better page understanding by search engines

🔗Enhanced internal linking context

🎯Improved content categorization

📊Better featured snippet eligibility

Ready to validate your WebPage schema? Test your page content and web document markup.

✓Validate Webpage Schema→

JSON-LD Example

Complete WebPage schema for an article page:

{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "name": "Ultimate Guide to Schema Markup",
  "url": "https://yoursite.com/ultimate-guide-to-schema-markup",
  "description": "Comprehensive guide to implementing structured data markup for better SEO and rich search results",
  "inLanguage": "en",
  "isPartOf": {
    "@type": "WebSite",
    "@id": "https://yoursite.com/#website"
  },
  "mainEntity": {
    "@type": "Article",
    "@id": "https://yoursite.com/ultimate-guide-to-schema-markup#article"
  },
  "breadcrumb": {
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://yoursite.com"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Guides",
        "item": "https://yoursite.com/guides"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "Ultimate Guide to Schema Markup",
        "item": "https://yoursite.com/ultimate-guide-to-schema-markup"
      }
    ]
  },
  "datePublished": "2026-01-10",
  "dateModified": "2026-01-10"
}

Breaking Down the Example

Core Properties:

@type: Must be "WebPage"
name: Page title
url: Page URL
description: Page description

Relationship Properties:

isPartOf: Links to WebSite schema
mainEntity: Primary content on page
breadcrumb: Navigation structure
inLanguage: Page language

Practical Use Cases

📝 Article & Blog Pages

Every blog post and article page should have WebPage schema pointing to the Article schema as the main entity. This creates a clear content hierarchy.

Example: A blog post page uses WebPage schema to establish it's part of your site, with the Article as the main content.

Impact: Search engines understand the page structure and can better feature your content in rich results.

🏢 About & Company Pages

About pages, company information, and corporate pages use WebPage schema to establish page type and relationship to your organization.

Example: Your "About Us" page uses WebPage schema with breadcrumb navigation and links to Organization schema.

Impact: Better understanding of corporate pages and improved internal linking context for search engines.

📄 Service & Landing Pages

Service pages, product category pages, and landing pages benefit from WebPage schema to establish content relationships and navigation context.

Example: A service page uses WebPage schema with breadcrumbs showing the path from home to the specific service.

Impact: Improved crawling efficiency and better representation of your site's information architecture.

Common Mistakes & How to Avoid Them

❌ Missing isPartOf Relationship

Mistake: Using WebPage schema without linking it to your WebSite schema, creating disconnected page descriptions.

Fix: Always include "isPartOf" pointing to your WebSite schema. This establishes the page-site relationship that search engines need.

❌ Wrong Main Entity References

Mistake: mainEntity pointing to non-existent or incorrect schema IDs on the same page.

Fix: Ensure mainEntity @id matches the @id of your primary content schema (Article, Product, etc.) on that page.

⚠️ Over-complicating with Unnecessary Properties

Mistake: Adding every possible WebPage property even when not applicable or useful.

Fix: Focus on relevant properties: name, url, description, isPartOf, mainEntity, and breadcrumb. Don't add properties just because they're available.

⚠️ Inconsistent Page Descriptions

Mistake: WebPage description doesn't match the actual page content or meta description.

Fix: Use the same description as your meta description or page content. Schema should accurately reflect what users see.

SEO Tip: Foundation for Rich Results

WebPage schema creates the foundation that enables rich results. It provides the page-level context that makes your content schemas more effective.

Article Schema

Blog posts and news articles

Product Schema

E-commerce product pages

FAQPage Schema

Frequently asked questions

Validate Your WebPage Schema

Test your WebPage schema implementation to ensure proper page structure and relationship definitions.

Test with SchemaValidator

Our comprehensive validation tool

Google Rich Results Test

Official Google testing tool

Related Schema Types

WebPage schema connects to these schemas to create comprehensive page descriptions and content relationships.

WebSite Schema

Site-wide context and structure

Article Schema

Blog posts and editorial content

BreadcrumbList Schema

Page navigation and hierarchy

Frequently Asked Questions

What is WebPage schema used for?

WebPage schema describes individual web pages and their content structure. It provides context about page type, navigation, and relationships to other pages, helping search engines understand and display page information more effectively.

How do I add WebPage schema to my website pages?

Add JSON-LD structured data to individual pages with required properties like url and name. Include optional properties like description, inLanguage, and isPartOf for enhanced page context.

What are the required properties for WebPage schema?

The only required property is url (page URL). However, for rich results eligibility, you'll typically need name (page title) and description for optimal display.

When should I use WebPage schema vs other page-specific schemas?

Use WebPage schema as a foundation for all pages, then combine it with specific content schemas like Article, Product, or Event. WebPage provides the page-level context that other schemas build upon.

How do I specify page type with WebPage schema?

Use specific WebPage subtypes like AboutPage, ContactPage, or CollectionPage to indicate page purpose. This helps search engines understand page function and display appropriate features.

Can WebPage schema include navigation information?

Yes, use breadcrumb property to include navigation hierarchy and relatedLink for related pages. This helps search engines understand site structure and page relationships.

How do I add language information to WebPage schema?

Use inLanguage property to specify page language (e.g., "en-US", "es-ES"). For multilingual sites, include available language versions through translationOfWork property.

Does WebPage schema help with site structure understanding?

Yes, WebPage schema provides crucial context about page relationships, navigation, and content hierarchy. It helps search engines understand how pages fit into your overall site structure.

Can WebPage schema include access restrictions?

Yes, use isAccessibleForFree and hasPart with isAccessibleForFree to indicate paywalled content. This helps search engines understand content availability and user access requirements.

How do I handle pagination with WebPage schema?

For paginated content, use pagination properties or create separate WebPage schemas for each page with appropriate relationships. Include navigation links between paginated pages.

What's the relationship between WebPage and WebSite schemas?

WebSite schema describes the overall website, while WebPage describes individual pages. Use isPartOf in WebPage to link to the parent WebSite schema for complete site representation.

Can WebPage schema include performance information?

While not directly supported, you can include loading performance data through additionalProperty. Focus on user experience metrics that indicate page quality and performance.

How often should I update WebPage schema?

Update when page content changes, navigation updates, or access restrictions change. Keep URLs, titles, and descriptions current to maintain accurate search engine understanding.

Additional JSON-LD Examples

E-commerce Product Page

WebPage schema for an e-commerce product page with product integration:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "@id": "https://example.com/products/smartphone-x-pro/#webpage",
  "url": "https://example.com/products/smartphone-x-pro",
  "name": "Smartphone X Pro - Premium Android Smartphone | TechStore",
  "description": "Discover the Smartphone X Pro with 5G connectivity, professional camera system, and all-day battery life. Available in multiple colors with free shipping.",
  "inLanguage": "en-US",
  "isPartOf": {
    "@type": "WebSite",
    "@id": "https://example.com/#website",
    "name": "TechStore",
    "url": "https://example.com"
  },
  "breadcrumb": {
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://example.com"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Smartphones",
        "item": "https://example.com/smartphones"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "Smartphone X Pro",
        "item": "https://example.com/products/smartphone-x-pro"
      }
    ]
  },
  "mainEntity": {
    "@type": "Product",
    "@id": "https://example.com/products/smartphone-x-pro/#product",
    "name": "Smartphone X Pro",
    "image": "https://example.com/products/smartphone-x-pro-main.jpg",
    "description": "Premium Android smartphone with 5G connectivity, professional camera system, and all-day battery life.",
    "brand": {
      "@type": "Brand",
      "name": "TechBrand"
    },
    "offers": {
      "@type": "Offer",
      "price": "899.99",
      "priceCurrency": "USD",
      "availability": "https://schema.org/InStock",
      "seller": {
        "@type": "Organization",
        "name": "TechStore"
      }
    },
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "4.5",
      "ratingCount": "1247"
    }
  },
  "relatedLink": [
    "https://example.com/products/smartphone-x-pro/reviews",
    "https://example.com/products/smartphone-x-pro/specifications",
    "https://example.com/products/smartphone-x-pro/accessories"
  ],
  "significantLink": "https://example.com/products/smartphone-x-pro/buy-now",
  "lastReviewed": "2024-01-15T10:30:00Z",
  "reviewedBy": {
    "@type": "Organization",
    "name": "TechStore Product Team"
  },
  "publisher": {
    "@type": "Organization",
    "@id": "https://example.com/#organization",
    "name": "TechStore",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.svg"
    }
  },
  "datePublished": "2023-09-01T00:00:00Z",
  "dateModified": "2024-01-15T10:30:00Z",
  "author": {
    "@type": "Organization",
    "name": "TechStore Content Team"
  }
}
</script>

Blog Article Page

WebPage schema for a blog article page with article content integration:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "@id": "https://example.com/guides/digital-marketing-trends-2024/#webpage",
  "url": "https://example.com/guides/digital-marketing-trends-2024",
  "name": "Digital Marketing Trends 2024: What Marketers Need to Know",
  "description": "Stay ahead of the curve with our comprehensive guide to digital marketing trends for 2024. From AI-powered personalization to voice search optimization, discover what's shaping the future of digital marketing.",
  "inLanguage": "en-US",
  "isPartOf": {
    "@type": "WebSite",
    "@id": "https://example.com/#website",
    "name": "Marketing Insights Blog",
    "url": "https://example.com"
  },
  "breadcrumb": {
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://example.com"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Blog",
        "item": "https://example.com/guides"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "Digital Marketing",
        "item": "https://example.com/guides/category/digital-marketing"
      },
      {
        "@type": "ListItem",
        "position": 4,
        "name": "Digital Marketing Trends 2024",
        "item": "https://example.com/guides/digital-marketing-trends-2024"
      }
    ]
  },
  "mainEntity": {
    "@type": "Article",
    "@id": "https://example.com/guides/digital-marketing-trends-2024/#article",
    "headline": "Digital Marketing Trends 2024: What Marketers Need to Know",
    "description": "Comprehensive analysis of emerging digital marketing trends and strategies for 2024.",
    "image": "https://example.com/guides/digital-marketing-trends-2024-hero.jpg",
    "datePublished": "2024-01-10T08:00:00Z",
    "dateModified": "2024-01-12T14:30:00Z",
    "author": {
      "@type": "Person",
      "name": "Jennifer Walsh",
      "jobTitle": "Digital Marketing Director",
      "worksFor": {
        "@type": "Organization",
        "name": "Marketing Insights Agency"
      }
    },
    "publisher": {
      "@type": "Organization",
      "@id": "https://example.com/#organization",
      "name": "Marketing Insights Blog",
      "logo": {
        "@type": "ImageObject",
        "url": "https://example.com/logo.svg"
      }
    },
    "wordCount": 2847,
    "keywords": ["digital marketing", "marketing trends", "SEO", "social media", "AI marketing"],
    "articleSection": "Digital Marketing"
  },
  "relatedLink": [
    "https://example.com/guides/seo-best-practices-2024",
    "https://example.com/guides/social-media-marketing-guide",
    "https://example.com/guides/ai-marketing-tools"
  ],
  "significantLink": "https://example.com/guides/digital-marketing-trends-2024#download-guide",
  "lastReviewed": "2024-01-12T14:30:00Z",
  "reviewedBy": {
    "@type": "Person",
    "name": "Sarah Chen",
    "jobTitle": "Content Editor"
  },
  "about": [
    {
      "@type": "DefinedTerm",
      "name": "Digital Marketing",
      "description": "Marketing activities that use digital technologies and channels"
    },
    {
      "@type": "DefinedTerm",
      "name": "SEO",
      "description": "Search Engine Optimization techniques"
    }
  ],
  "mentions": [
    {
      "@type": "Organization",
      "name": "Google"
    },
    {
      "@type": "Organization",
      "name": "Meta"
    },
    {
      "@type": "DefinedTerm",
      "name": "Artificial Intelligence"
    }
  ],
  "datePublished": "2024-01-10T08:00:00Z",
  "dateModified": "2024-01-12T14:30:00Z",
  "author": {
    "@type": "Person",
    "name": "Jennifer Walsh"
  }
}
</script>

SEO & Rich Results Notes

SEO Benefits

WebPage schema provides essential context for page-level optimization:

• Enhanced page context for search engines
• Improved site structure understanding
• Better content categorization and indexing
• Enhanced breadcrumb navigation in search results
• Improved page relationship mapping

Rich Results Eligibility

WebPage schema enables enhanced page displays:

• Breadcrumb navigation in search results
• Page type identification and display
• Content relationship mapping
• Site structure context provision
• Enhanced page metadata display

Reference: Google's Search Central recommends WebPage markup for comprehensive page context and site structure representation.

Important Warnings

URL Accuracy: Page URLs must exactly match the actual page URL. Incorrect URLs can cause indexing and display issues.
Content Consistency: Page titles and descriptions must match visible page content. Misleading metadata can result in search penalties.
Relationship Integrity: Page relationships (breadcrumbs, related links) must be accurate and functional. Broken navigation harms user experience.
Access Declaration: Clearly indicate content access restrictions. Misrepresenting paywalled or restricted content violates user trust.

Official Documentation

Schema.org: WebPage specification
Google Search Central: Structured Data Guidelines
Rich Results Test: Validate WebPage markup

← Back to Schema Types