New website or upgrading an existing one? Book a free video consultation.
Englishen
Login Configurator

Structured data (Schema)

Structured data is additional markup in a page's code that tells the search engine, in a language it understands, what the page represents: that it is a product, what its price is, whether it is in stock, how it is rated, and what the shipping and return terms are. The search engine does not show this data to the visitor directly, but uses it for a richer display of your result in the listings, and increasingly to understand your page at all and cite it in answers generated by artificial intelligence. Below is how structured data helps, which types matter for a store, how to avoid the most common mistakes, and how to set it up.

What structured data is

It is a standardised vocabulary, Schema.org, that all major search engines understand. The recommended format is JSON-LD - a self-contained block of data in the page's code, separate from the visible content, that is simple to add and maintain. For the best effect it should be included in the page's initial HTML. It is important to understand that structured data on its own does not raise rankings - Google states this explicitly and repeatedly. What it does is make the page eligible for a rich display, and give it an advantage in being correctly understood by the search engine and by AI assistants. The effect is therefore indirect: the same ranking, but noticeably more clicks.

Why it pays off: clicks and AI visibility

With correct markup your result can show rating stars, the price, an availability label, and shipping and return details - all before the visitor clicks. Such a result stands out among plain listings; measurements show typically around 30 percent higher click-through for pages with rich results. An increasingly important second role: AI Overviews and assistants such as ChatGPT, Gemini, and Perplexity rely heavily on structured data when citing sources. Pages with valid JSON-LD have a markedly greater chance of being cited - often the difference between being cited and being invisible.

Which types matter for a store

  • Product with an included Offer (price, currency, availability, condition) and ideally AggregateRating or Review; add identifiers SKU, GTIN, or MPN so the product is recognised.
  • BreadcrumbList to show the path to the page in the result.
  • Organization with company details, logo, and links to profiles - also the basis for the new shipping and return data.

For a rich result the markup must contain at least the product name and one of: price, rating (aggregateRating), or review. The combination of Product, Offer, and ratings triggers the most noticeable display, since it adds the price and stars - the signals that most influence the decision to click on shopping searches.

New: shipping and returns in the markup

At the end of 2025 Google made it possible for every store to share its shipping and return terms, not only those with a Merchant Center account. There are two paths: entering them directly in Google Search Console, or markup at the organisation level (OfferShippingDetails for the cost and delivery time, MerchantReturnPolicy for the window and cost of returns). The result can then show free shipping, the delivery time, or favourable return terms - strong arguments just before the click.

Correctness is key - and common mistakes

A rich result requires certain mandatory properties. If any is missing or wrong, the search engine does not show a trimmed result but omits the entire rich display. The most common mistakes:

  • Price mismatch: the price in the markup must match the visible price on the page, written as a number without a currency symbol.
  • Invalid values: wrong availability labels, dates outside the YYYY-MM-DD format, or text instead of a number.
  • Broken images: the image URL must open and point to the actual product image.
  • Fabricated reviews: ratings must be genuine, with real authors and dates; most platforms show stars only from about three reviews onward. Fabricated or editorial reviews are a policy violation and can lead to a manual penalty.
  • Duplicate markup: no multiple Product entries for the same product; with several products on a page, distinguish each with an identifier (SKU or GTIN).

The rule behind all of them: the markup must match what the visitor actually sees on the page. Mark up only what is truly present.

How to set it up in Magento

Magento's default theme (Luma) adds only basic markup in microdata format and often without key properties such as availability, the offer, reviews, and shipping - which is not enough for all rich results. For reliable Product schema in JSON-LD with Offer and ratings, BreadcrumbList, Organization, and shipping and return data, a dedicated module or a theme customisation is usually required. Such a module adds the structured data to product, category, and content pages automatically, fills it from the product on the fly (price, stock, ratings) so the markup needs no manual upkeep, and inserts it into the initial HTML. After enabling it, check a few representative pages with the official Rich Results Test and the Schema Markup Validator.

How to measure whether it works

In Google Search Console track the enhancement reports (Product snippets, Merchant listings, Breadcrumbs): they show how many pages are valid and where the errors are that need fixing. In parallel watch the click-through on product pages - once stars, the price, and shipping appear in the result, it typically rises. The goal is not only that the markup is valid, but that the rich display actually appears and brings more clicks at the same ranking, and more citations in AI answers.

Sources

Frequently Asked Questions

What is structured data and what does it give me?

It is additional markup in a page's code following the Schema.org standard, most often in JSON-LD format, that tells the search engine what the page represents: that it is a product, what the price is, whether it is in stock, how it is rated, and what the shipping and return terms are. The search engine does not show it to the visitor directly, but uses it for a richer display of your result - with stars, the price, and availability - which at the same ranking brings typically around 30 percent more clicks. An increasingly important second role: AI assistants rely heavily on this very markup when citing sources.

Do structured data raise the ranking in the search engine?

Not directly; Google states this explicitly and repeatedly. What they do is make the page eligible for a rich display (stars, price, availability, shipping) and give it an advantage in being correctly understood by the search engine and by AI assistants. The effect is therefore indirect: the same ranking, but noticeably more clicks and more citations in AI answers. Pages with valid JSON-LD are often cited where a page without it is not.

Which markup matters for an online store and what is mandatory?

The most important are: Product with an included Offer (price, currency, availability, condition) and ideally AggregateRating or Review for product pages, to which you add the identifiers SKU, GTIN, or MPN; BreadcrumbList for the path in the result; and Organization with company details, a logo, and links to profiles. For a rich result the markup must contain at least the product name and one of: price, rating, or review. The combination of Product, Offer, and ratings triggers the most noticeable display, since it adds the price and stars.

What are the most common mistakes that break the rich display?

If any mandatory property is missing or wrong, the search engine omits the entire rich display. The most common: the price in the markup does not match the visible price or has a currency symbol (it must be a bare number); invalid availability values or dates in the wrong format; broken image URLs; fabricated or editorial reviews (ratings must be genuine, and most platforms show stars only from about three reviews onward); and duplicate Product markup for the same product. The rule behind it: the markup must match what the visitor actually sees on the page - mark up only what is truly present.

How do I set this up in Magento and how do I check whether it works?

Magento's default theme (Luma) adds only basic markup in microdata format and often without key properties (availability, the offer, reviews, shipping), which is not enough. For reliable Product schema in JSON-LD with Offer and ratings, BreadcrumbList, Organization, and shipping and return data, a dedicated module or a theme customisation is usually required, one that adds the markup to all pages automatically, fills it from the product, and inserts it into the initial HTML. After enabling it, check a few pages with the official Rich Results Test, then track the enhancement reports in Google Search Console (Product snippets, Merchant listings, Breadcrumbs) and the click-through.

Stop browsing. Start selling. Contact me now at anze@degriz.net.

Access Premium Content for Free

Subscribe to our newsletter and get free access to premium content. Discover valuable insights and exclusive resources available only to our subscribers.

Privacy Policy: Newsletter Subscription

By entering your email address, you are subscribing to the newsletter, through which Degriz will inform you about new online and in-store offerings, marketing activities, and other promotions.

By subscribing to the newsletter, you are also enrolled in the benefits database that Degriz offers to its users.

For the newsletter subscription, Degriz d.o.o. collects the following information: email address, IP address, and if you subscribe as a registered member, your name, surname, address, and phone number.

After submitting the form with your email address, you will receive a confirmation message at the specified address – by confirming this, you will be subscribed to the Degriz newsletter until you unsubscribe (so-called opt-in approval). You can request, in writing or by clicking the Unsubscribe button in the newsletter, that the data controller permanently or temporarily stops using your personal data for direct marketing purposes. Your request will be fulfilled within 15 days of receiving it, as prescribed by law. You can also request the transfer or access to your data.

Degriz d.o.o. is committed to protecting your data in accordance with the legislation governing personal data protection.

The sender of the newsletter and controller of your personal data is: Degriz, d.o.o., Gorica pri Šmartnem 45a, 3000 Celje, SI 67287743

Check out the full Privacy Policy

Newsletter

My name is Anže, and I am a Magento certified expert in solutions and a creator of multiple award-winning online stores.

I am the architect behind all Degriz projects. You will surely come across me if we collaborate. Even though the phone keeps ringing, you can always tap me on the shoulder if you need advice regarding online stores and their functioning.

I specialize in building custom online stores and I am a master of unique techniques to enhance conversion on your website.

© 2010 - 2026 Degriz. All rights reserved. Built with love on Magento.
Partial use of the content is permitted with mandatory attribution. The content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0) or under our own license.