AIWebPageSEO › Schema Debugger Fixes › Debug Schema in Shopify

How to Debug Schema in Shopify

Shopify schema breaks have distinctive patterns: theme + app conflicts (both outputting Product), missing brand from empty Vendor field, FAQ schema on non-FAQ content. This guide covers the Shopify-specific debug workflow. Pair with schema debugger guide.

Step-by-step: How to debug Shopify schema

  1. Reproduce in Rich Results Test. search.google.com/test/rich-results on affected URL. Note exact errors and warnings. Save the detected JSON-LD for comparison after fixes.
  2. Categorise. Common categories: 1) Syntax (invalid JSON, missing braces). 2) Missing required field (Product without offers.price, missing brand). 3) Wrong @type. 4) @id collision (theme + app both outputting). 5) Type mismatch (date as text, not ISO 8601).
  3. Find source plugin/theme. View source. Find distinctive field/value. Search Shopify admin for app names — does an installed app handle schema? Or check theme files (product.liquid usually contains the Product schema).
  4. Fix theme + app conflicts. Most common Shopify schema issue. Theme outputs Product, app outputs Product — duplicates with @id collisions. Resolution: pick one (usually app for flexibility), disable other. App settings often have 'disable theme schema' toggle.
  5. Fix missing brand. Shopify uses Vendor field as schema brand. Empty Vendor = missing brand. Audit: bulk export products, filter Vendor blank, populate.
  6. Fix date format issues. Article schema dates must be ISO 8601 (e.g., '2026-01-15T10:30:00+00:00'). Theme should output correctly; if not, edit blog article.liquid template's date output.
  7. Re-validate and monitor. Re-run Rich Results Test. Confirm errors cleared. Search Console → Enhancements → wait 1-7 days for re-crawl. Monitor monthly.
Tip. Document your Shopify configuration choices in a single internal doc (theme version, installed apps, custom code edits). When something breaks after a theme or app update, you have a baseline to compare against.

🔍 Debug Shopify schema

Find errors, conflicts and missing fields.

Run Schema Debugger →

Frequently Asked Questions

Why does my Shopify schema show duplicate Product?

Theme and an installed app both output Product schema. JSON-LD for SEO, Smart SEO, Schema Plus all default to outputting Product on /products/* — and so does your theme. Solution: disable theme's Product schema (edit product.liquid, remove the JSON-LD block) or disable app's schema output. Pick one as authority.

Shopify says 'missing field publisher.logo' on Article — how do I fix?

Theme.liquid → add complete Organization JSON-LD in head with logo URL. Logo requirements: 600x60 min, ≤112KB, PNG/JPG. Article schema references publisher.logo via @id of the Organization.

Why does Shopify Article schema show wrong date?

Theme using wrong field. Some themes use article.created_at; should be article.published_at for datePublished. Edit blog article.liquid to use correct field. Modified date should be article.updated_at if you want dateModified.

Can I have schema in both theme and Pages-section content?

Yes if consistent. Inconsistent (theme says 'Product A' but page HTML says 'Product B') confuses Google. Best practice: theme handles structural schema, Pages section is for marketing copy only (no manual schema blocks).

Shopify Rich Results Test passes but Search Console shows errors — why?

Search Console's validator is slightly stricter. Common gap: Rich Results Test allows warnings; Search Console marks similar issues as errors. Address all warnings in Rich Results Test proactively.

Related Guides

Got a problem?