What is structured data?
Structured data is information about a page written in a standardized format and with a shared vocabulary, such as Schema.org, so a search engine or another program knows what the page contains without deducing it from the text: that a product page sells a specific product, at what price, in what currency and whether it is in stock. It does not change what the visitor sees.
Key takeaways
- Structured data describes the page in named fields (product, price, currency, availability) so a machine does not have to interpret it.
- It is built from three separate pieces: a vocabulary (Schema.org), a format (JSON-LD, microdata or RDFa) and the requirements of whoever reads it.
- It makes a page eligible for rich results on Google, but does not guarantee them even when the markup is correct.
- Google does not require it for its generative AI features and still recommends keeping it as part of SEO.
- The rule most often broken in a store: the data has to say the same thing as the visible page, including after a sale.
When people talk about structured data in an online store, they are almost always talking about a block of code that the product page carries inside and that no customer reads: a second description of the page, written for machines. It says the same thing as the visible product page (the name, the price, the currency, whether there is stock left), but in named fields, so a search engine does not have to guess it by reading the text. It matters for two reasons: Google uses it to understand the page and to decide whether it can show it with more information in the results, and when it does not match what the customer sees, the one with the problem is the store.
How it works
Google defines it as a standardized format for providing information about a page and classifying its content. Its example is a recipe: structured data says what the ingredients are, the cooking time and temperature, or the calories. Google uses what it finds to understand the page's content and, more generally, to gather information about the web and the world.[1]Google Search Central. Introduction to structured data markup in Google Search
Behind the phrase there are three pieces, and it pays not to mix them up because each has its own page in this glossary:
- The vocabulary: what things exist and what properties they have. The most widely used is Schema.org, a project founded by Google, Microsoft, Yahoo and Yandex,[2]Schema.org. Schema.org and most of the structured data that Google Search reads uses that vocabulary.[1]Google Search Central. Introduction to structured data markup in Google Search In a store, the two types that weigh the most are the product, Product, and its offer, Offer.
- The format: how that is written inside the HTML. Google supports three, JSON-LD, microdata and RDFa, and recommends JSON-LD because it is the easiest to implement and maintain at scale, with less room for error.[1]Google Search Central. Introduction to structured data markup in Google Search
- The requirements of whoever reads it: which properties each search engine asks for, for each type of result. Google warns that, to know how its search engine behaves, the definitive reference is its own documentation and not Schema.org's.[1]Google Search Central. Introduction to structured data markup in Google Search
What a store gets out of it is, above all, the chance to qualify for rich results. On product pages, Google can show the price, availability, ratings or shipping details in the results.[3]Google Search Central. Introduction to Product structured data To qualify, you have to include all the required properties for the result type,[1]Google Search Central. Introduction to structured data markup in Google Search and even then it is not assured: Google does not guarantee that your structured data will show up in the results even when the markup is correct.[4]Google Search Central. General structured data guidelines The cases Google publishes give an idea of the prize: Rotten Tomatoes measured a click-through rate 25% higher on pages with markup, and Nestlé, an 82% higher click-through rate on pages that appear as a rich result.[1]Google Search Central. Introduction to structured data markup in Google Search
For the generative AI features in Search, Google is equally clear in both directions. Structured data is not a requirement and there is no special Schema.org markup for them; still, it advises keeping it as part of your SEO strategy, because it helps you qualify for rich results.[5]Google Search Central. Optimizing your website for generative AI features on Google Search For products it adds one more piece: providing structured data on the page and also a product feed in Google Merchant Center is what maximizes your chances of appearing, and helps it understand and verify the data.[3]Google Search Central. Introduction to Product structured data
And there is a rule that changes what you do. Structured data has to be a faithful representation of the page's content, and you do not mark up anything the reader cannot see.[4]Google Search Central. General structured data guidelines You put it on the page it describes,[4]Google Search Central. General structured data guidelines and with the most specific type that exists in Schema.org.[4]Google Search Central. General structured data guidelines Skipping those guidelines can end in a manual action, which removes the page's chance of appearing as a rich result without changing its position in web search.[4]Google Search Central. General structured data guidelines
In a store
Any product page, with what the customer sees and what the machines read side by side. Fictional example: the store, the product and the prices are made up to show the mechanism.
| Field | What the customer sees | What the machines read | Does it match? |
|---|---|---|---|
| Name | Marlow linen shirt, blue | "name": "Marlow linen shirt, blue" |
Yes |
| Price | $29.90 (was $39.90) | "price": "39.90" |
No |
| Currency | $ | "priceCurrency": "USD" |
Yes |
| Availability | "Only a few left" in size M | "availability": "https://schema.org/InStock" |
Yes, with caveats |
The price row is the typical mismatch of a sale: the theme shows the discounted price, but the data block comes from a field nobody updated. For the customer the product page is fine; for Google's rule, the data no longer represents the page.[4]Google Search Central. General structured data guidelines The availability row shows something else: the vocabulary has no value for "only a few left," so what the page says and what the data says cannot always be matched word for word, only in fact.
What gets mixed up
Believing that having structured data is having rich results. The first you decide; the second Google decides, and it does not guarantee it even with perfect markup.[4]Google Search Central. General structured data guidelines A green validator says the markup can be read, not that it will be shown.
How to check it
- Run a product page's URL through the Rich Results Test. It tells you which rich result types it finds and what errors or suggestions the markup has. By default it tests the page as a mobile device.[6]Search Console Help. Rich Results Test
- Compare field by field what the test extracts with what a customer sees on the product page: name, price, currency, availability and image. Any difference breaks the faithful-representation rule.[4]Google Search Central. General structured data guidelines
- Confirm in Search Console that Google has found the data, with the URL Inspection tool.[1]Google Search Central. Introduction to structured data markup in Google Search Also look at the manual actions report.[4]Google Search Central. General structured data guidelines
- Repeat the test after every price or stock change. The data has to change at the same time as the page, not at the next sync.
Related concept: rich results
Structured data is what you write on the page; rich results are what Google decides to show with it: the price, the stars or the availability next to the link. The first is a condition for the second, never a guarantee.[4]Google Search Central. General structured data guidelines And if someone talks to you about schema markup, they are talking about structured data under another name: markup made with the Schema.org vocabulary, which is the one most of the structured data in Google Search uses.[1]Google Search Central. Introduction to structured data markup in Google Search
To keep going, the structured data reading path puts the rest of the terms in order, the guide to auditing a product page's structured data goes into the detail and, if you are unsure between this markup, the llms.txt file and the XML sitemap, the comparison llms.txt, sitemap and structured data separates what each one does.
Synonyms
- English
- structured data, structured data markup
- Español
- marcado de datos estructurados
Sources
- [1] Google Search Central. Introduction to structured data markup in Google Search. Accessed . ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑
- [2] Schema.org. Schema.org. Accessed . ↑
- [3] Google Search Central. Introduction to Product structured data. Accessed . ↑ ↑
- [4] Google Search Central. General structured data guidelines. Accessed . ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑
- [5] Google Search Central. Optimizing your website for generative AI features on Google Search. Accessed . ↑
- [6] Search Console Help. Rich Results Test. Accessed . ↑
Change history
- First English version.
This definition is published under CC BY 4.0. Reuse this definition freely, crediting Clione with a link to this page.
Related terms
Schema.org
What Schema.org is, who maintains it, how its types and properties are organized, and why it is not the same as the format or as what Google requires.
JSON-LD
What JSON-LD is, what @context, @type, @id and @graph mean, why Google recommends it and how to find and check the block on your product page.
Product
What the Schema.org Product type is, which properties it carries, what Google requires for product snippets and merchant listings, and how to check it.
Offer
What the Schema.org Offer type is, how to write price, currency and availability, what Google requires, and how Offer differs from AggregateOffer.
Rich results
What Google rich results are, which ones matter in a store, why valid markup doesn't guarantee you'll see them, and how to check.
Microdata
What HTML microdata is, how it is written with itemscope, itemtype and itemprop, what Google says compared with JSON-LD and how to check it in your store.
Make your catalog easy for bots to read
Clione fills every product page with what bots read best: the JSON-LD graph with its structured data, the meta description and the FAQs. You review and press Push; then we check your live store so it all stays published.