Adding Schema Markup to Shopify: A Step-by-Step Guide

In your Shopify admin, navigate to Online Store → Themes. Find your active theme (or your duplicate), click the ⋯ menu → Edit code. This opens Shopify's built-in code editor.

In the left sidebar under Layout, click theme. liquid. This is your store's master template. Find the closing </head> tag; you'll paste your schema just before it.

Copy the code below and paste it immediately before the closing </head> tag. Replace the placeholder values with your actual store details. The {% if request.page_type == 'index' %} tag ensures this only outputs on the homepage.

{% if request.page_type == 'index' %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "{{ shop.name }}",
  "url": "{{ shop.url }}",
  "potentialAction": {
    "@type": "SearchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "{{ shop.url }}/search?q={search_term_string}"
    },
    "query-input": "required name=search_term_string"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "{{ shop.name }}",
  "url": "{{ shop.url }}",
  "logo": "YOUR_LOGO_URL_HERE",
  "sameAs": [
    "YOUR_TWITTER_URL",
    "YOUR_FACEBOOK_URL",
    "YOUR_INSTAGRAM_URL"
  ]
}
</script>
{% endif %}

Click Save in the top right. The {{ shop.name }} and {{ shop.url }} are Liquid variables. Shopify replaces them automatically with your actual store name and URL.

In the code editor, look under Templates for one of these files depending on your theme version:

• Older themes: product.liquid
• Dawn / newer themes: product.json (references sections) open main-product.liquid under Sections instead

Scroll to the very top of the file and paste your schema block at the beginning, before any other output.

This schema uses Liquid variables to dynamically populate every field with your actual product data; no manual editing is required per product.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "{{ product.title | escape }}",
  "description": "{{ product.description | strip_html | truncate: 300 | escape }}",
  "url": "{{ shop.url }}{{ product.url }}",
  "image": "{{ product.featured_image | img_url: 'master' }}",
  "sku": "{{ product.selected_or_first_available_variant.sku | escape }}",
  "brand": {
    "@type": "Brand",
    "name": "{{ product.vendor | escape }}"
  },
  "offers": {
    "@type": "Offer",
    "url": "{{ shop.url }}{{ product.url }}",
    "priceCurrency": "{{ cart.currency.iso_code }}",
    "price": "{{ product.selected_or_first_available_variant.price | money_without_currency | remove: ',' }}",
    "availability": "https://schema.org/{% if product.available %}InStock{% else %}OutOfStock{% endif %}",
    "priceValidUntil": "{{ 'now' | date: '%s' | plus: 2592000 | date: '%Y-%m-%d' }}",
    "seller": {
      "@type": "Organization",
      "name": "{{ shop.name | escape }}"
    }
  }
}
</script>

All the {{ }} tags are Liquid. Shopify replaces them with real product data at render time. The priceValidUntil field is set to 30 days from now automatically.

If your store has a reviews app (Judge.me, Yotpo, Okendo, Loox, etc.) that exposes review data as Liquid variables, you can include an aggregateRating block in your Product schema. Star ratings in search results are one of the highest-CTR rich results available.

Add this block inside your Product schema JSON, after the offers block:

// Example using Judge.me Liquid variables adjust for your reviews app
{% if product.metafields.reviews.rating.value != blank %},
"aggregateRating": {
  "@type": "AggregateRating",
  "ratingValue": "{{ product.metafields.reviews.rating.value }}",
  "reviewCount": "{{ product.metafields.reviews.rating_count.value }}",
  "bestRating": "5",
  "worstRating": "1"
}
{% endif %}

Check your reviews app's documentation for the exact Liquid variable names; they vary between apps. Judge.me uses product. metafields.reviews. rating.value; Yotpo and others use different paths.

Use the appropriate Schemify generator for your page type:

• About page: Organization Schema Generator
• FAQ page: FAQ Schema Generator
• Contact page: WebPage Schema Generator

Fill in the form and copy the generated JSON-LD output including the <script type="application/ld+json"> tags.

In your Shopify admin, go to Online Store → Pages and open the page you want to add schema to. In the content editor, click the <> Source code button (or "Show HTML" depending on your editor version) to switch to HTML view.

Paste your schema <script> block at the very beginning of the HTML content area, before any visible content. Click Save.

In the code editor, open collection.liquid (older themes) or main-collection-product-grid.liquid under Sections (Dawn and newer themes). Add the following at the top of the file:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "CollectionPage",
  "name": "{{ collection.title | escape }}",
  "description": "{{ collection.description | strip_html | truncate: 200 | escape }}",
  "url": "{{ shop.url }}{{ collection.url }}"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "{{ shop.url }}"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "{{ collection.title | escape }}",
      "item": "{{ shop.url }}{{ collection.url }}"
    }
  ]
}
</script>

Go to search.google.com/test/rich-results. Enter your page URL (e.g. a product page URL) and click Test URL. Google will crawl the live page and show whether your schema is valid and eligible for rich results.

For pages not yet published, use the Test code tab and paste your full rendered HTML or just the JSON-LD block to test it directly without needing a live URL.

In Google Search Console, go to Enhancements in the left sidebar. You'll see entries for each schema type Google has found on your site, products, breadcrumbs, etc. along with any errors or warnings. This is the most authoritative view of how Google sees your schema across your entire store.

After adding new schema, submit your sitemap via Sitemaps and request indexing for key pages via URL Inspection → Request Indexing to speed up the process.