Shopify Product JSON-LD Schema Template: Fields, Liquid Variables and Validation

A Shopify Product JSON-LD template should be boring in the best possible way: predictable, accurate, and easy to validate after every theme change.

What we have seen in StoreBuilt schema audits is this: product structured data usually breaks when a store treats it as a one-time paste rather than a maintained template. Price, currency, image, availability, variant, review, and description fields all depend on real storefront data. If that data moves, the markup has to keep up.

Use the free Shopify schema generator to create a template starting point. If your product pages already output multiple Product entities or inconsistent Offer data, Contact StoreBuilt before adding another snippet.

Table of contents

• What Product JSON-LD should represent
• Core fields for a Shopify product template
• Liquid variables and maintenance risk
• Variant, price, and availability decisions
• Review data and AggregateRating caution
• StoreBuilt example from a Product schema rebuild
• Validation workflow for Shopify teams
• Final StoreBuilt point of view

What Product JSON-LD should represent

Product JSON-LD tells search engines what a product page is about. It should match the visible product page closely.

The page should focus on a specific product or a product variant relationship that can be explained clearly. Google’s Product guidance is especially careful about product pages, offer data, variants, and markup accuracy.

For Shopify teams, the practical rule is this: if a shopper cannot see or experience the data on the page, be cautious about marking it up.

That includes:

• price
• availability
• product name
• product image
• SKU
• brand
• ratings
• review count

Structured data should clarify the page, not decorate it.

Core fields for a Shopify product template

Most Shopify Product JSON-LD templates need these core pieces:

Schema field	Shopify source to consider	QA question
@type: Product	product template	is this page a product page?
name	product.title	does it match visible product title?
description	product description or SEO-safe excerpt	is it useful and not broken HTML?
image	featured image or selected variant image	is the URL valid and current?
brand	vendor, metafield, or brand setting	is brand naming consistent?
sku	selected variant SKU	is SKU maintained?
offers.price	selected variant price	does it match visible price?
offers.priceCurrency	shop or market currency	is currency correct for the URL?
offers.availability	selected variant availability	does it update correctly?

The StoreBuilt schema generator provides both static and Liquid-style examples so the team can see how these pieces fit together.

Liquid variables and maintenance risk

Liquid variables make schema maintainable, but they need careful handling.

Watch for:

• empty fields
• unescaped text
• HTML inside descriptions
• missing images
• products without SKUs
• variant data that changes after selection
• market-specific pricing
• review app data injected separately

The template should handle missing fields gracefully. A blank SKU may be acceptable if SKU data is not maintained. A broken JSON string caused by unescaped copy is not.

This is why schema work belongs in theme QA, not just content entry.

Variant, price, and availability decisions

Variants create real implementation decisions.

Some stores use one product URL for multiple variants. Some create variant-specific URLs. Some have market-specific pricing or availability. The schema strategy should match the storefront experience.

Ask:

• which variant is selected by default?
• does the visible price change by variant?
• does the JSON-LD update or represent the default variant?
• do variants have distinct SKUs?
• are variant images represented correctly?
• does availability match what shoppers can buy?

For many Shopify themes, a simple Product with Offer for the selected or first available variant is a practical baseline. More complex variant markup may be needed for stores where variant-specific search visibility matters.

Review data and AggregateRating caution

Review data should not be invented, estimated, or hidden.

Add AggregateRating only when:

• reviews are genuine
• the rating is visible on the product page
• review count is accurate
• the review app or data source is maintained
• there is no duplicate conflicting review markup

If a review app already outputs review schema, the theme should not blindly add another AggregateRating layer. Duplicate or conflicting schema can make validation harder and reduce trust in the implementation.

For stores with review-app complexity, schema review often overlaps with Apps, Integrations & Automation and Shopify SEO & AI Search Readiness.

StoreBuilt example from a Product schema rebuild

One store had Product JSON-LD in the theme, review markup from an app, and a second Product entity from a legacy SEO snippet. Each layer looked understandable on its own. Together, they created inconsistent signals.

The rebuild started by removing duplication, choosing one Product schema owner, and making Offer fields dynamic from Shopify product data. Review markup stayed with the review system because that was the source of truth.

The final template was less dramatic than the old setup, but it was easier to validate and maintain.

Validation workflow for Shopify teams

Use this workflow after implementation:

1. Generate or draft the schema.
2. Add it to a duplicate theme or development branch.
3. Render a real product page.
4. Validate the rendered URL.
5. Compare markup with visible page content.
6. Test products with different prices, stock states, images, and missing fields.
7. Check whether apps add duplicate markup.
8. Document ownership.

Do not validate only the code snippet before Liquid renders. The live page is what matters.

Product schema QA table

Test product	Why test it
standard in-stock product	confirms baseline schema
out-of-stock product	tests availability
discounted product	checks price output
multi-variant product	checks selected variant logic
product without SKU	checks graceful fallback
product with reviews	checks rating ownership
product without reviews	prevents fake rating markup

This mix catches issues that one perfect sample product will miss.

Final StoreBuilt point of view

Product JSON-LD is not a trophy snippet. It is part of the product template.

StoreBuilt’s view is that Shopify schema should be owned like any other technical component. Use a generator to understand the structure, but implement with real product data, test edge cases, and keep the markup aligned with the shopper-facing page.

For help turning a generated snippet into a maintainable theme pattern, use the free schema generator, then Contact StoreBuilt.