In beta, with limited placesOpen to everyone in Q1 2027

↑↓ to move · Enter to open · Esc to close

Structured data

What is schema markup, and what does it mean when someone asks for it?

Schema markup is code added to a page to describe its content with the Schema.org vocabulary, written in JSON-LD, microdata or RDFa, so a search engine knows what the page presents (a product, an offer, an organization) and with what data. It is the industry's name for structured data built with that vocabulary.

Written by
Reviewed by
Published 7 min read
Takeaway:

Key takeaways

  • Schema markup is the industry's term for markup built with the Schema.org vocabulary; in Google's documentation, the general idea is called structured data.
  • The term does not name the format: it can be a separate JSON-LD block or microdata attributes on the visible text, and for Google all three formats count the same if they are done right.
  • In Google it serves to qualify for rich results, with no guarantee and only for the types Google still shows: the FAQ rich result stopped appearing on May 7, 2026.
  • There is no special schema markup for Google's generative AI features, and Google still advises using it as part of SEO.
  • When a proposal promises schema markup, ask which types, on which pages, where the data comes from and how it will be checked.

The phrase usually reaches you as a to-do item: "missing schema markup" in an audit, "add schema markup to your products" on an app listing, "we will implement schema markup across the whole store" in an agency proposal. It is not a product, not a plugin, and not something different from structured data, which has its own entry. It is what the industry calls structured data written with the Schema.org vocabulary. The useful question for a store is a different one: what exactly are they telling you when they say schema markup, and what do you need to ask to know whether what they offer is worth anything?

What each word means

Schema is the vocabulary. Schema.org is a community project, founded by Google, Microsoft, Yahoo and Yandex, that creates and maintains schemas for structured data on the web, and its vocabulary covers entities, the relationships between them and actions.⁠[1]Schema.org. Schema.org In practice these are the fixed names of things, such as Product or Organization, and of their properties, such as price or brand.

Markup is the act of marking up the HTML. Schema.org's getting-started guide explains it with a title tag: <h1>Avatar</h1> tells the browser how to display the text, but not what it means, and "Avatar" could be the movie or a profile picture. Marking up the page means adding tags that tell the search engine what each piece of data is about, so it can understand it and display it usefully.⁠[2]Schema.org. Getting started with schema.org using Microdata The word dates from when this was done with attributes on the visible text, known as microdata. Today the same vocabulary can also be written in RDFa or in JSON-LD,⁠[2]Schema.org. Getting started with schema.org using Microdata which sits in a block separate from the text, and the name has stuck even though nothing visible is marked up anymore.

So the phrase tells you which vocabulary, but not which format. Google does not care: it accepts all three, recommends the one that is easiest for you to implement and maintain (in most cases, JSON-LD) and says all three are equal to it if the markup is valid and follows the documentation for each feature.⁠[3]Google Search Central. Introduction to structured data markup in Google Search The volume gives an idea of how established it is: according to Schema.org, in 2024 more than 45 million domains marked up their pages with more than 450 billion objects from its vocabulary.⁠[1]Schema.org. Schema.org

What it gets you in Google, in 2026

Google uses structured data to understand a page's content and to display it with a richer appearance in the results, which it calls rich results.⁠[4]Google Search Central. Structured data markup that Google Search supports There are two limits that a schema markup proposal does not always mention.

The first: Google does not guarantee that your structured data will appear in the results, even when the markup is correct according to its own testing tool.⁠[5]Google Search Central. General structured data guidelines Marking up is a condition for qualifying, not a result.

The second: the catalog of rich results changes, and in the last two years it has shrunk. In September 2025 Google retired the documentation for several types it no longer showed, such as course info, estimated salary and vehicle listings. The FAQ rich result stopped appearing in Search on May 7, 2026, and in June Google also retired its documentation.⁠[6]Google Search Central. Latest documentation updates FAQPage markup is still valid vocabulary, but it no longer produces that rich result in Google. For a store, what is still alive and growing is product markup: in July 2026 Google expanded the documentation for merchant listings to accept the product category.⁠[6]Google Search Central. Latest documentation updates

And for the generative AI features in Search, Google is explicit: structured data is not a requirement and there is no special Schema.org markup you need to add; it still advises using it as part of your SEO strategy, because it helps you qualify for rich results.⁠[7]Google Search Central. Optimizing your website for generative AI features on Google Search

In a store

A proposal line like "we will implement schema markup across the whole store" says almost nothing until five questions are answered. Fictional example: the line is made up, and the answers in the third column are the ones you can check against Google's documentation.

Question Why it matters An answer you can check
Which types? The vocabulary has hundreds; Google uses only some for its rich results.⁠[4]Google Search Central. Structured data markup that Google Search supports Product with its offer on product pages, BreadcrumbList on pages with breadcrumbs, Organization on the home page.
On which pages? Not everything goes everywhere. Google recommends putting organization data on the home page or on a single page that describes the organization, not on every page.⁠[8]Google Search Central. Organization structured data
Where does the data come from? The markup has to say what the visible page says.⁠[5]Google Search Central. General structured data guidelines From the same field that renders the price or name on the product page, not from a separate copy.
How many properties? More is not better. Google prefers a few recommended properties that are complete and accurate over many that are incomplete or malformed.⁠[3]Google Search Central. Introduction to structured data markup in Google Search
How is it checked? What is not measured is not delivered. The Rich Results Test on a published URL, before and after.⁠[9]Search Console Help. Rich Results Test

The fourth row is the one that saves the most money. Google says you must include all the required properties for a type to qualify for the rich result, and that adding recommended ones can help, but that it is more important to provide fewer properties that are complete and accurate than to try to provide them all with incomplete or inaccurate data.⁠[3]Google Search Central. Introduction to structured data markup in Google Search A quote priced by "number of properties marked up" is measuring the wrong thing.

Warning:

What gets mixed up

Believing there is a schema markup "for AI" that is different from the usual one, and paying for it separately. For the generative AI features in its search engine, Google says there is no special Schema.org markup to add.⁠[7]Google Search Central. Optimizing your website for generative AI features on Google Search What does count is the usual markup, complete and faithful to the page.

How to check

  1. See what markup you already have. In the source of a product page, look for application/ld+json (JSON-LD), itemscope (microdata) and typeof (RDFa). Before you buy schema markup, know how much your theme already ships.
  2. Run the URL through the Rich Results Test. It accepts all three formats and tells you which rich result types it finds, with their errors and suggestions.⁠[9]Search Console Help. Rich Results Test
  3. Compare each type against Google's gallery, the list of markup Search supports today.⁠[4]Google Search Central. Structured data markup that Google Search supports If a type is not there, do not expect a rich result from it in Google.
  4. Check the changelog of Google's documentation before accepting a quote: that is where features being retired and expanded are announced.⁠[6]Google Search Central. Latest documentation updates
  5. Compare what the markup says with what a customer sees, field by field. What is not visible on the page is not marked up.⁠[5]Google Search Central. General structured data guidelines

Structured data is the general idea: a standardized format for providing information about a page and classifying its content.⁠[3]Google Search Central. Introduction to structured data markup in Google Search Schema markup is that idea built with one specific vocabulary, Schema.org, and since most of the structured data Google Search uses relies on that vocabulary,⁠[3]Google Search Central. Introduction to structured data markup in Google Search in a store the two names usually point to the same block of code. The difference matters when someone uses "schema" to mean only JSON-LD, or only the app that generates it: the vocabulary, the format and the tool are three different things, and a serious proposal names all three.

To go further, the structured data reading path puts the rest of the terms in order, and the guide to auditing a product page's structured data applies these questions to a whole product page.

Synonyms

English
schema markup, schema.org markup
Español
marcado schema, marcado de Schema.org

Sources

  1. [1] Schema.org. Schema.org. Accessed . ↑ ↑
  2. [2] Schema.org. Getting started with schema.org using Microdata. Accessed . ↑ ↑
  3. [3] Google Search Central. Introduction to structured data markup in Google Search. Accessed . ↑ ↑ ↑ ↑ ↑
  4. [5] Google Search Central. General structured data guidelines. Accessed . ↑ ↑ ↑
  5. [6] Google Search Central. Latest documentation updates. Accessed . ↑ ↑ ↑
  6. [7] Google Search Central. Optimizing your website for generative AI features on Google Search. Accessed . ↑ ↑
  7. [8] Google Search Central. Organization structured data. Accessed . ↑
  8. [9] Search Console Help. Rich Results Test. Accessed . ↑ ↑

Change history

  • First English version, translated from the Spanish original.

This definition is published under CC BY 4.0. Reuse this definition freely, crediting Clione with a link to this page.

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.