Shopify Structured Data Explained: Product, Offer, Reviews and What Your Theme Already Adds

Structured data is the part of your store that shoppers never see. It's a block of code in each page that tells search engines, in a fixed format, "this is a product, it costs $24, it's in stock, it's made by this brand, and 212 people rated it 4.8".

When it's complete and correct, Google can show that information directly in search results: price, stock, star ratings, shipping and returns. AI assistants and shopping tools can read your product facts without guessing. When it's incomplete, duplicated or wrong, you miss out on those results, and sometimes lose them without noticing.

The good news for Shopify merchants is that your theme probably does a lot of this already. This guide shows you what it covers, what it usually leaves out, how to check yours in five minutes, and how to fill the gaps safely.

What structured data does (and doesn't do)

On Shopify, structured data is almost always JSON-LD: a <script type="application/ld+json"> block in the page's HTML that uses the schema.org vocabulary. A simplified Product block looks like this:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Merino Crew Hiking Socks",
  "image": "https://yourstore.com/cdn/shop/files/merino-crew-sock.jpg",
  "brand": { "@type": "Brand", "name": "Northfield" },
  "gtin13": "5012345678900",
  "offers": {
    "@type": "Offer",
    "price": "24.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  },
  "aggregateRating": { "@type": "AggregateRating", "ratingValue": "4.8", "reviewCount": "212" }
}

What it does:

• Makes your products eligible for richer Google results: product snippets (rating, price, stock under the normal result) and merchant listings (product details in shopping-style results, including shipping and returns).
• Gives search engines, AI assistants and shopping tools your product facts in a form they don't have to interpret: the exact price, currency, stock, brand and identifiers.

What it doesn't do:

• It isn't a direct ranking boost. Good markup doesn't move a page up the results by itself. It changes how the result looks and how well machines understand it.
• It doesn't guarantee rich results. Google decides whether to show them, case by case.
• It can't describe things that aren't on the page. Markup has to match what shoppers can see.

What your Shopify theme already adds

Most modern Shopify themes, including Shopify's own Dawn and many Online Store 2.0 themes, generate product structured data with Shopify's structured_data filter, a single line in the product section such as {{ product | structured_data }}. Shopify builds the block from your product data, so it updates by itself when prices or stock change. Older or heavily customised themes may write their own JSON-LD by hand, or use an older format called microdata (itemprop attributes in the HTML).

In practice, that usually means:

• Usually there: name, image, description, URL, SKU, price, currency and availability. That's enough for a basic product result.
• Depends on your theme and data: brand (usually taken from the Vendor field), GTIN (only if the variant Barcode field is filled in), ratings (only if a reviews app provides them), variants described as a group, and Organization markup on the home page.
• Usually missing: shipping costs and delivery times, the return policy, breadcrumbs, and product specifications such as material or size.

Check yours in five minutes

Want to see what a complete Product block looks like for your own product? Build one with the free Schema Markup Generator and compare it field by field with what your theme outputs.

Field by field: where each value comes from

Most gaps are fixed by filling in data in Shopify, not by editing code, because the theme builds the markup from your product data.

Six common problems

Variants, shipping and returns

Products with sizes and colours

A product with variants is really a family of items, each with its own price, stock and often its own GTIN. Google supports describing this as a ProductGroup: one parent with productGroupID, the attributes it variesBy (such as size and colour), and each variant as a hasVariant Product with its own offer.

If your theme outputs a single Product with one price, the markup only describes one variant, usually the default. That's acceptable, but shoppers searching for a specific size or colour get less precise information. Check whether your theme or app supports ProductGroup. Either way, set a GTIN on every variant that has one.

Shipping and returns

Google can show shipping costs, delivery times and return windows in results. Shopify doesn't put this in the theme's markup by default, so you have two ways to provide it:

• In Google's own tools: state your shipping and return policies in Google Merchant Center, or in Search Console's settings for shopping information if you don't use Merchant Center. This applies store-wide and doesn't touch your theme.
• In the markup: shippingDetails and hasMerchantReturnPolicy on each offer, or a return policy on your Organization markup. This needs an app or theme code.

Whichever you use, keep it consistent with the shipping and returns policy pages shoppers actually read.

Other types worth having

• Organization on the home page: your store's name, logo, contact details and social profiles (sameAs). It helps search engines and AI assistants connect your store to your brand. Some themes include it. Check your home page in the Rich Results Test or the Schema Markup Validator.
• BreadcrumbList: shows your site structure (Home › Socks › Hiking socks) and can appear in results instead of the raw URL. Many themes don't include it.
• Article on blog posts: headline, author, date and image. Themes using {{ article | structured_data }} already add it.
• FAQPage: still valid markup, and it describes question-and-answer content clearly to machines. But since 2023, Google only shows FAQ rich results for well-known government and health websites, so don't expect expandable FAQs under your store's results.

How to add what's missing

Work through these in order. Most stores never need to go past the first.

1. Fill in your Shopify data. Set a consistent Vendor (brand), fill in Barcode on every variant that has a GTIN, and switch on your reviews app's structured data option. Because the theme builds its markup from this data, these changes flow into structured data automatically.
2. Use one app for what the theme can't do: variants as a ProductGroup, shipping, returns, Organization details. Choose an app that adds only the fields your theme is missing rather than a second full Product block, and check it can be switched off cleanly.
3. Edit the theme code only if you're comfortable with Liquid or have a developer. Duplicate the theme first, make the change in the copy, test it in the Rich Results Test, then publish. Replace the theme's block rather than adding a second one beside it.

Checklist

FAQ

Does structured data improve my rankings?

Not directly. It makes your pages eligible for richer results and helps machines understand your products, which can improve how many people click. Where you rank still depends on your content, links and overall site quality.

My markup is valid. Why don't I see stars in Google?

Valid markup makes a page eligible, but Google decides whether to show rich results for each search. It can also take a while after Google re-crawls the page. Check that the rating is in the markup, that the reviews are visible on the page, and that the Search Console Product snippets report shows the page as valid.

Do I need an app for structured data?

Not necessarily. If your theme uses Shopify's structured_data filter and your product data is complete (vendor, barcodes, a reviews app that provides ratings), you may already have most of what you need. An app is useful for what themes rarely cover: variants as a group, shipping and returns, and Organization details.

Can bad structured data hurt my store?

Markup that misleads, such as fake or hidden reviews or prices that don't match the page, can lead Google to ignore it or apply a manual action that removes rich results. Honest markup that matches the page is safe.