Shopify15 min·6 steps

How to Add Schema Markup to Shopify (2026 Step-by-Step Guide)

Q: What's the best schema markup app for Shopify?

JSON-LD for SEO by Schema-LD is the most popular and well-maintained choice. Set it up once and it handles Organization, Product (with reviews from Judge.me, Yotpo, Loox), Article, BreadcrumbList, and FAQ across the entire store. Other options: Smart SEO , Schema Plus . Free schema apps tend to be limited; expect to pay $5-20/month for a good one.

Q: Can I add custom schema markup to Shopify without an app?

Yes - paste JSON-LD blocks directly into theme.liquid or page-specific templates ( article.liquid , product.liquid , etc.). Use Liquid template variables to dynamically populate fields. The trade-off is maintenance: you have to update the schema when Shopify or your theme changes. Apps handle that for you.

Q: How do I check if my Shopify schema is working?

Three checks. (1) Run individual URLs through Google's Rich Results Test for per-page validation. (2) URL Inspection in Search Console shows what Google's crawler parsed from any URL. (3) Search Console Enhancements shows aggregate counts (Product valid pages, FAQ valid pages, etc.) after Google has crawled your site for 1-2 weeks.

Shopify themes emit basic Product schema (name, image, price, availability) automatically on product pages. The work is filling in the gaps: Organization schema for the storefront, Article/BlogPosting for blog posts, BreadcrumbList for navigation context, FAQPage for FAQ pages, and full aggregateRating + review on products. Most stores can solve all of these with a single JSON-LD app, or by editing theme.liquid directly.

What you'll need before you start

•A Shopify store on any plan
•Owner or staff with permission to edit themes (or install apps)
•Roughly 15 minutes

How to add schema markup on Shopify: Step-by-step

1
Audit what schema you already have
Run your homepage, a product page, a collection page, and a blog post through Google's Rich Results Test. Note which schema types are detected and what's missing. Most Shopify themes emit Product, BreadcrumbList, and partial Organization by default. Common gaps: full Organization (with logo + social profiles), aggregateRating + review on products, Article schema on blog posts.
2
Install JSON-LD for SEO (the recommended app)
The most popular schema app on Shopify is JSON-LD for SEO by Schema-LD - it handles the gaps automatically: Organization, Product (with reviews if you use a supported review app), Article, BreadcrumbList, FAQ, Recipe, and more. In Shopify admin: Apps → Shopify App Store → search JSON-LD for SEO → install. Configure once, ship.
3
Alternative: edit theme.liquid for custom Organization schema
If you prefer not to install an app, paste a hand-written Organization JSON-LD block into theme.liquid. In Shopify: Online Store → Themes → Edit code on your active theme. Open layout/theme.liquid. Just before the closing </head> tag, paste:
```
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "{{ shop.name }}",
  "url": "{{ shop.url }}",
  "logo": "{{ 'logo.png' | asset_url }}",
  "sameAs": [
    "https://twitter.com/yourhandle",
    "https://www.instagram.com/yourhandle"
  ]
}
</script>
```
Update the social URLs and logo path to match your store.
4
Add Article schema to blog posts
The default Shopify blog template typically lacks proper Article schema. Either rely on the JSON-LD for SEO app (which handles this), OR edit templates/article.liquid to inject an Article block in the <head>. Required fields: headline, image, datePublished, author, publisher. The Liquid template variables to use are {{ article.title }}, {{ article.image | img_url: 'master' }}, {{ article.published_at | date: '%FT%T%:z' }}, etc.
5
Add aggregate ratings to product schema
Shopify's default Product schema doesn't include reviews. To add aggregateRating and review fields, you need a review app that emits the data: Judge.me, Yotpo, Loox, and Stamped all do this. Most plug into JSON-LD for SEO automatically. Once reviews are flowing, the Product schema picks them up and rich snippets become eligible (star ratings in Google search results).
6
Validate every page type
Run a homepage, product page, collection page, blog post, and FAQ page through Google's Rich Results Test. Fix every error. Common issues: missing required Product fields (image URL must be absolute, price must be in the right currency format), missing publisher on Article schema, broken sameAs URLs.

How to verify your setup is working

Rich Results Test is the fastest validation per page. Schema.org Validator gives a more comprehensive check. After 1-2 weeks of crawls, Search Console Enhancements shows aggregate counts of valid Product, Article, FAQ pages and any errors. URL Inspection on a specific page shows what Google's crawler actually parsed.

Common issues and fixes

I'm getting duplicate Product schema errors

Two common causes. (1) Both your theme AND a JSON-LD app are emitting Product schema for the same product page. Disable one. (2) Your theme is emitting one Product schema and your reviews app is emitting another with different fields. Modern review apps usually inject into the existing Product schema rather than creating a duplicate, but older versions sometimes don't - update the app or contact its support.

Product schema is missing aggregate ratings

Default Shopify Product schema doesn't include reviews. You need either a review app (Judge.me, Yotpo, Loox, Stamped) that emits aggregateRating into the schema, OR a JSON-LD app like JSON-LD for SEO that pulls review data from the app and injects it. Without one of these, your product rich snippets won't show stars.

Schema validates but Google search isn't showing rich snippets

Validation isn't a guarantee of rich-snippet display. Common reasons valid schema doesn't surface: (1) the page is too new and hasn't built authority yet, (2) Google's quality threshold for the specific snippet type isn't met (e.g., review aggregateRating needs at least a few reviews), (3) Google is choosing a competitor's page. Wait 4-6 weeks and check Search Console Enhancements for any quality issues.

Frequently asked questions

Does Shopify add schema markup automatically?

Most Shopify themes emit basic Product schema (name, image, price, availability) and partial Organization schema automatically. The gaps - Article schema on blog posts, full Organization with logo + social profiles, aggregateRating + review on products - typically need a JSON-LD app or theme edits to fill.

What's the best schema markup app for Shopify?

JSON-LD for SEO by Schema-LD is the most popular and well-maintained choice. Set it up once and it handles Organization, Product (with reviews from Judge.me, Yotpo, Loox), Article, BreadcrumbList, and FAQ across the entire store. Other options: Smart SEO, Schema Plus. Free schema apps tend to be limited; expect to pay $5-20/month for a good one.

How do I add FAQ schema to Shopify?

Easiest path is JSON-LD for SEO - it has a FAQ block builder. Manual path: paste a JSON-LD FAQPage block directly into your FAQ page's HTML using a Custom Liquid section in the page editor, or edit templates/page.faq.liquid to inject schema based on a CMS-managed Q&A list.

Will schema markup help my Shopify SEO?

It doesn't directly improve rankings, but it improves visibility in two big ways. (1) Rich snippets in Google search results (star ratings, prices, availability) increase click-through rate. (2) AI assistants (ChatGPT, Perplexity, Gemini) heavily favor schema-marked pages when generating citations - which matters more every quarter as AI search grows. For ecommerce specifically, schema is increasingly table-stakes.

Can I add custom schema markup to Shopify without an app?

Yes - paste JSON-LD blocks directly into theme.liquid or page-specific templates (article.liquid, product.liquid, etc.). Use Liquid template variables to dynamically populate fields. The trade-off is maintenance: you have to update the schema when Shopify or your theme changes. Apps handle that for you.

How do I check if my Shopify schema is working?

Three checks. (1) Run individual URLs through Google's Rich Results Test for per-page validation. (2) URL Inspection in Search Console shows what Google's crawler parsed from any URL. (3) Search Console Enhancements shows aggregate counts (Product valid pages, FAQ valid pages, etc.) after Google has crawled your site for 1-2 weeks.

Related Guides

How to Add Schema Markup to Your Website

How to Add Schema Markup to WordPress

How to Set Up Google Search Console on Shopify

Once you're set up, MeasureBoard turns the data into action

MeasureBoard connects to your analytics, search, and SEO tooling and generates AI-powered weekly reports, GEO readiness scores, and a dedicated AI analyst that answers questions in plain English. Free to start, connects in 30 seconds.

Get Started Free