SchemaValidatorSchemaValidator

How to Validate WebSite Schema

WebSite schema markup provides search engines with comprehensive information about your entire website, enabling rich site links, search box integration, and enhanced site-wide search visibility.

What is WebSite Schema?

WebSite schema describes your entire website as a single entity. Unlike content-specific schemas that describe individual pages or product pages, WebSite schema gives search engines the big picture of your online presence.

Why WebSite Schema Matters

Most websites implement schemas for individual pages but forget the foundational WebSite markup. WebSite schema tells search engines what your site is about, who owns it through organizational information, and how users can search within it directly from search results.

The key insight: WebSite schema is the foundation that makes all your other schemas more effective. It's the "table of contents" for your entire website.

What WebSite Schema Includes

•Site-wide identification and branding
•Ownership and organizational information
•Search functionality integration
•Site navigation and structure

SEO Benefits You Get

🔍Sitelink rich results
🔎Site-specific search box in results
🏷️Enhanced brand recognition
📊Better site authority signals

Ready to validate your Website schema? Test your site-wide structure and navigation markup.

✓Validate Website Schema→

WebSite Schema Implementation

Complete WebSite Schema Example

Comprehensive WebSite schema with search functionality:
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "@id": "https://example.com/#website",
  "url": "https://example.com",
  "name": "Example Company",
  "description": "Leading provider of innovative solutions for modern businesses and digital transformation",
  "publisher": {
    "@id": "https://example.com/#organization"
  },
  "copyrightHolder": {
    "@id": "https://example.com/#organization"
  },
  "potentialAction": {
    "@type": "SearchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://example.com/search?q={search_term_string}"
    },
    "query-input": "required name=search_term_string"
  },
  "sameAs": [
    "https://facebook.com/example",
    "https://twitter.com/example",
    "https://linkedin.com/company/example"
  ]
}
</script>

Required vs Recommended Properties

Required Properties

  • •@type: Must be "WebSite"
  • •url: Your site's main URL
  • •name: Your site/brand name

Recommended Properties

  • •description: Site description
  • •potentialAction: Search functionality
  • •publisher: Organization info
  • •sameAs: Social media profiles

Search Action Integration

The most powerful feature of WebSite schema is enabling search directly from Google results. When implemented correctly, users see a search box in your site's rich results.

Search Action Structure:

"potentialAction": {
  "@type": "SearchAction",
  "target": "https://example.com/search?q={search_term_string}",
  "query-input": "required name=search_term_string"
}

Important: The search URL must actually work on your site. Test it manually to ensure search results load properly.

WebSite Schema Best Practices

Implementation Strategy

  • 📍Place on homepage only: WebSite schema should appear on your main page, not every page
  • 🔗Use absolute URLs: Always include full URLs with https:// protocol
  • 🏷️Match your brand: Use the exact name and description from your main branding
  • 🔍Test search functionality: Ensure the search URL in potentialAction actually works

Advanced Features

Multi-language Support

"inLanguage": ["en", "es", "fr"]

Copyright Information

"copyrightHolder": {"@id": "#organization"},
"copyrightYear": "2024"

Site Navigation

"mainEntity": {"@id": "#breadcrumb"}

Common WebSite Schema Mistakes

  • ❌Wrong search URL: Using a non-functional search endpoint in potentialAction
  • ❌Generic descriptions: Using boilerplate text instead of your actual site description
  • ❌Missing Organization link: Not connecting to your Organization schema with @id references
  • ❌On every page: Implementing WebSite schema on individual pages instead of just the homepage

Validate Your WebSite Schema

Test your WebSite schema implementation to ensure proper site-wide markup and search functionality.

Test with SchemaValidator

Our comprehensive validation tool

Google Rich Results Test

Official Google testing tool

Related Schema Types

WebSite schema works with these foundational schemas for complete site representation.

Organization Schema

For business/brand information

WebPage Schema

For individual page information

BreadcrumbList Schema

For site navigation structure

Frequently Asked Questions

What is WebSite schema used for?

WebSite schema describes the overall website structure, navigation, and search functionality. It provides context for search engines about site-wide features like search boxes, site navigation, and potential actions users can take.

How do I add WebSite schema to my website?

Add JSON-LD structured data to your homepage with required properties like name and url. Include optional properties like publisher, potentialAction for search functionality, and inLanguage for site language.

What are the required properties for WebSite schema?

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

How do I add search functionality to WebSite schema?

Use potentialAction with SearchAction to describe site search functionality. Include target URL template with search query parameters to enable search box features in search results.

Can WebSite schema include navigation information?

Yes, use mainEntity with ItemList to describe main navigation menus. Include primary navigation items and their relationships to help search engines understand site structure.

What's the difference between WebSite and Organization schemas?

WebSite schema describes the online presence and technical aspects of your site, while Organization schema describes the business entity behind it. Use both together for complete representation.

Does WebSite schema enable rich results?

Yes! WebSite schema can enable search box features in search results and provides context for other page-level schemas. It helps search engines understand your site's capabilities and structure.

Can WebSite schema include mobile app information?

Yes, use potentialAction with DownloadAction to link to mobile apps. Include app store URLs and platform information to connect your website with mobile applications.

How do I specify site language and audience?

Use inLanguage for primary site language and audience with audienceType for target demographics. Include geographic targeting with serviceArea for regional sites.

Can WebSite schema include social media profiles?

While not directly supported in WebSite schema, link social profiles through the Organization schema using sameAs. This provides complete online presence representation.

How do I handle multi-language websites?

Use inLanguage array for multiple languages and translationOfWork to link language versions. Include hreflang attributes in your HTML for proper language targeting.

Does WebSite schema improve site-wide SEO?

Yes, WebSite schema provides crucial context about your site's structure and capabilities. It helps search engines understand navigation, search functionality, and overall site purpose.

How often should I update WebSite schema?

Update when site structure changes, new features are added, or search functionality is modified. Keep URLs, names, and navigation information current.

Additional JSON-LD Examples

E-commerce Website

WebSite schema for an e-commerce website with search functionality and shopping features:
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "@id": "https://example.com/#website",
  "url": "https://example.com",
  "name": "TechStore - Premium Electronics & Gadgets",
  "description": "Your trusted destination for premium electronics, gadgets, and tech accessories. Free shipping on orders over $50 with 30-day returns.",
  "inLanguage": "en-US",
  "copyrightHolder": {
    "@type": "Organization",
    "@id": "https://example.com/#organization",
    "name": "TechStore Inc."
  },
  "publisher": {
    "@type": "Organization",
    "@id": "https://example.com/#organization",
    "name": "TechStore Inc.",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.svg",
      "width": 200,
      "height": 60
    }
  },
  "potentialAction": [
    {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://example.com/search?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    },
    {
      "@type": "DownloadAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://apps.apple.com/app/techstore/id123456789",
        "inLanguage": "en-US",
        "actionPlatform": [
          "https://schema.org/IOSPlatform"
        ]
      },
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "name": "Terms of Service",
        "url": "https://example.com/terms"
      }
    }
  ],
  "mainEntity": {
    "@type": "ItemList",
    "name": "Main Navigation",
    "itemListElement": [
      {
        "@type": "SiteNavigationElement",
        "position": 1,
        "name": "Smartphones",
        "url": "https://example.com/smartphones"
      },
      {
        "@type": "SiteNavigationElement",
        "position": 2,
        "name": "Laptops",
        "url": "https://example.com/laptops"
      },
      {
        "@type": "SiteNavigationElement",
        "position": 3,
        "name": "Accessories",
        "url": "https://example.com/accessories"
      },
      {
        "@type": "SiteNavigationElement",
        "position": 4,
        "name": "Support",
        "url": "https://example.com/support"
      }
    ]
  },
  "about": [
    {
      "@type": "Thing",
      "name": "Consumer Electronics",
      "description": "Electronic devices and gadgets for personal and professional use"
    },
    {
      "@type": "Thing",
      "name": "E-commerce",
      "description": "Online retail and electronic commerce"
    }
  ],
  "audience": {
    "@type": "Audience",
    "audienceType": "consumers",
    "geographicArea": {
      "@type": "Country",
      "name": "United States"
    }
  },
  "sameAs": [
    "https://www.facebook.com/techstore",
    "https://www.instagram.com/techstore",
    "https://twitter.com/techstore"
  ],
  "serviceArea": {
    "@type": "Country",
    "name": "United States"
  }
}
</script>

Content Publishing Website

WebSite schema for a content publishing website with news and articles:
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "@id": "https://example.com/#website",
  "url": "https://example.com",
  "name": "Global News Network",
  "description": "Breaking news, in-depth analysis, and comprehensive coverage of world events, politics, business, technology, and culture.",
  "inLanguage": ["en-US", "es-ES", "fr-FR"],
  "copyrightHolder": {
    "@type": "Organization",
    "@id": "https://example.com/#organization",
    "name": "Global News Network Inc."
  },
  "publisher": {
    "@type": "Organization",
    "@id": "https://example.com/#organization",
    "name": "Global News Network",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.svg",
      "width": 300,
      "height": 60
    },
    "foundingDate": "1998-06-15",
    "sameAs": [
      "https://www.facebook.com/globalnews",
      "https://twitter.com/globalnews",
      "https://www.linkedin.com/company/global-news-network"
    ]
  },
  "potentialAction": [
    {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://example.com/search?q={search_term_string}&lang={language}"
      },
      "query-input": "required name=search_term_string",
      "query-language": "optional name=language"
    },
    {
      "@type": "CommunicateAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://example.com/contact",
        "inLanguage": "en-US"
      }
    }
  ],
  "mainEntity": {
    "@type": "ItemList",
    "name": "Site Sections",
    "itemListElement": [
      {
        "@type": "SiteNavigationElement",
        "position": 1,
        "name": "World News",
        "url": "https://example.com/world"
      },
      {
        "@type": "SiteNavigationElement",
        "position": 2,
        "name": "Politics",
        "url": "https://example.com/politics"
      },
      {
        "@type": "SiteNavigationElement",
        "position": 3,
        "name": "Business",
        "url": "https://example.com/business"
      },
      {
        "@type": "SiteNavigationElement",
        "position": 4,
        "name": "Technology",
        "url": "https://example.com/technology"
      },
      {
        "@type": "SiteNavigationElement",
        "position": 5,
        "name": "Sports",
        "url": "https://example.com/sports"
      }
    ]
  },
  "about": [
    {
      "@type": "Thing",
      "name": "Journalism",
      "description": "The activity of gathering, assessing, creating, and presenting news and information"
    },
    {
      "@type": "Thing",
      "name": "Current Events",
      "description": "Recent events and developments of public interest"
    }
  ],
  "audience": {
    "@type": "Audience",
    "audienceType": "general public",
    "geographicArea": {
      "@type": "Country",
      "name": "United States"
    }
  },
  "knowsAbout": [
    "Politics",
    "Business",
    "Technology",
    "Sports",
    "International Relations",
    "Economics"
  ],
  "hasPart": [
    {
      "@type": "WebPage",
      "name": "Privacy Policy",
      "url": "https://example.com/privacy"
    },
    {
      "@type": "WebPage",
      "name": "Terms of Service",
      "url": "https://example.com/terms"
    }
  ]
}
</script>

SEO & Rich Results Notes

SEO Benefits

WebSite schema provides foundational context for site-wide optimization:

  • • Enhanced site structure understanding by search engines
  • • Search box integration in search results
  • • Improved navigation and site relationship mapping
  • • Better targeting for site-wide search queries
  • • Enhanced brand and site authority signals

Rich Results Eligibility

WebSite schema enables enhanced site-wide displays:

  • • Search box in search results (Sitelinks Search Box)
  • • Enhanced site links and navigation
  • • Site-wide knowledge panel integration
  • • Mobile app download integration
  • • Site structure and navigation context

Reference: Google's Search Central recommends WebSite markup for comprehensive site representation and search box integration.

Important Warnings

  • URL Consistency: Website URL must exactly match your domain. Incorrect URLs can cause indexing issues and search box malfunctions.
  • Search Functionality: If you include search actions, the search URLs must work correctly. Broken search functionality harms user experience.
  • Content Accuracy: Site descriptions and information must match your actual content. Misleading site information can result in penalties.
  • Navigation Integrity: Main navigation items should accurately reflect your site structure. Incorrect navigation mapping confuses search engines.

Official Documentation

← Back to Schema Types

Frequently Asked Questions

What is Website schema used for?

Website schema provides structured data for website content and information. It helps search engines understand content details and enables rich results in search listings.

What are the key properties for Website 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 Website schema affect SEO?

Website 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.

When should I use Website schema?

Use Website schema when your content matches the schema type definition. It provides semantic meaning to your data and enables enhanced search features.

What are the benefits of Website 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 do I optimize Website schema for Indian audience?

Include 'inLanguage' property for Hindi support if your site is bilingual. Add searchAction with 'target' URL for site search. Include potentialAction for Hindi content. This helps Google.co.in understand your site structure and language support for Indian users.

🇮🇳 Should I use .in domain in Website schema?

Yes, use your actual domain URL (yoursite.in for India-focused sites). Website schema should reflect your registered domain. This helps Google.co.in properly attribute your site and improves visibility for Indian audience searches.

🇮🇳 Can Website schema help with site search ranking in India?

Absolutely! Website schema with searchAction property enables rich site search in Google.co.in results. Combined with proper BreadcrumbList schema on pages, it improves overall site structure understanding and helps Google.co.in display your content more effectively.

🇮🇳 How do I add multilingual support to Website schema for India?

Use 'inLanguage': ['en', 'hi'] or ['en-US', 'hi-IN'] for English and Hindi support. Add language-specific search actions in potentialAction array. This signals Google.co.in that your site serves Indian users in multiple languages.