← Back to all guides

Classification: Required · Last updated: April 2026

WebSite Schema for Shopify: The Complete Guide

WebSite schema markup tells Google about your website as a whole — its name, URL, search functionality, and the organization that publishes it. This structured data directly controls how your site name appears in search results and whether Google displays a sitelinks search box for your brand.

What Is WebSite Schema?

WebSite schema (schema.org/WebSite) is a JSON-LD structured data type that describes an entire website as an entity. While Organization schema tells Google who you are, WebSite schema tells Google about the website itself — what it's called, where it lives, and what search functionality it offers.

Google uses WebSite markup for two specific features:

• Site name display — The name shown in search results above your page URLs. Without WebSite schema, Google guesses your site name from your <title> tags, often getting it wrong
• Sitelinks search box — The search box that appears within your brand's search result, letting users search your site directly from Google

Why WebSite Schema Is Required

Every site that appears in Google search results has a site name displayed. Google explicitly states that WebSite structured data is the primary way to control what that name is. Without it:

• Google may display your domain name instead of your brand name
• Your site name might appear inconsistently across different search results
• You won't get a sitelinks search box for branded searches
• The connection between your WebSite and Organization entities is missing

Required Properties

According to Google's documentation for WebSite structured data:

• @type — Must be "WebSite"
• name — The name of your website as you want it displayed in search results. This is the primary input Google uses for your site name
• url — The canonical URL of your homepage (e.g., "https://yourstore.com")

Recommended Properties

• potentialAction — A SearchAction object that tells Google your site has internal search functionality. This is what enables the sitelinks search box. You specify your search URL template with a {search_term_string} placeholder that Google replaces with the user's query
• publisher — A reference to your Organization entity using @id. This connects your WebSite to your Organization in Google's knowledge graph
• alternateName — Any alternative names for your site (abbreviations, nicknames, or previous names). Google may use these to match user queries
• inLanguage — The primary language of your website using an IETF BCP 47 language code (e.g., "en-GB", "en-US"). Helps Google understand your target audience
• description — A brief description of what your website is about

JSON-LD Example for Shopify

{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "@id": "https://yourstore.com/#website",
  "name": "Your Store Name",
  "url": "https://yourstore.com",
  "publisher": {
    "@id": "https://yourstore.com/#organization"
  },
  "potentialAction": {
    "@type": "SearchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://yourstore.com/search?q={search_term_string}"
    },
    "query-input": "required name=search_term_string"
  },
  "alternateName": "YSN",
  "inLanguage": "en-GB"
}

Sitelinks Search Box — How It Works

The sitelinks search box is one of the most visible benefits of WebSite schema. When a user searches for your brand name, Google may display a search box within your result that lets users search your site directly. To enable this:

1. Include the potentialAction property with a valid SearchAction
2. Your urlTemplate must point to your actual search page with a working query parameter
3. For Shopify stores, this is typically https://yourstore.com/search?q={search_term_string}
4. Google must be able to verify that the search URL works by testing it

Note: Google doesn't guarantee the sitelinks search box will appear. It's an algorithmic decision based on your site's prominence, user behaviour, and the quality of your search functionality.

Site Name in Search Results

Google's documentation explicitly states that WebSite structured data is the primary source for determining your site name in search results. The site name appears above your URL in every search result for your domain. Getting this right matters because:

• It's one of the first things users see — it builds brand recognition
• A wrong or missing site name looks unprofessional
• If Google can't determine your site name, it falls back to your domain name (e.g., "yourstore.com" instead of "Your Store Name")

Common Mistakes on Shopify Stores

• Missing WebSite schema entirely — Many themes include Product schema but skip WebSite, leaving Google to guess your site name
• Wrong search URL — Using a non-functional search endpoint in the potentialAction. Shopify's default search URL is /search?q= — make sure it matches your actual search path
• No publisher link — Omitting the publisher reference to your Organization. This breaks the entity connection in Google's knowledge graph
• Duplicate WebSite blocks — Theme and app both injecting WebSite schema, potentially with different names or URLs
• Using the .myshopify.com domain — Your WebSite URL should be your primary custom domain, not the default Shopify subdomain

How Schema Clinic Handles WebSite

Schema Clinic checks for WebSite schema on your homepage during every audit. Missing WebSite schema triggers an error and a Health Score penalty. If present, the audit validates that the name, URL, and search action are all correctly configured.

Pro plan users can generate WebSite schema with all required and recommended properties populated from their store data, including a working Shopify search action and @id entity linking to their Organization.

← Back to all guides