Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Explainers · Explainer

What Is Schema Markup? A Plain Explanation

What Is Schema Markup? A Plain Explanation

Short answer

Schema markup is structured data added to a page that tells search engines what the content means, in a standard format they can read. It uses the Schema.org vocabulary, usually written as JSON-LD. It can make a page eligible for rich results, such as star ratings or event dates.

Key takeaways

  • Schema markup is structured data that tells search engines what a page means, in a standard format.
  • Most sites use the Schema.org vocabulary, usually written as JSON-LD, which Google recommends.
  • Use the type that matches the page: Article for posts, Organization for the home page, Product for shop pages.
  • Markup must describe content visitors can see; hidden or fake markup can make a page ineligible.
  • Rotten Tomatoes saw a 25% higher click-through rate on pages with structured data, per Google.
  • Test markup with Google's Rich Results Test, then watch the status reports in Search Console.

What is schema markup?

Schema markup is structured data added to a page that tells search engines what the content means, in a standard format they can read.

It is code, not visible text. On a recipe page, for example, it labels the ingredients, cooking time, and calories, so a search engine knows those facts instead of guessing from the page text.

Google defines structured data as a standardized format for providing information about a page and classifying the page content, in its introduction to structured data.

The vocabulary most sites use comes from Schema.org, a shared project founded by Google, Microsoft, Yahoo, and Yandex. As of 2024, over 45 million web domains mark up their pages with over 450 billion Schema.org objects, according to schema.org.

How does schema markup work?

Schema markup labels parts of a page with named types and properties, so a search engine can read the facts directly.

A page about a book can carry markup that names the title, the author, and the publication date. A product page can name the price, the stock status, and the review score.

The search engine reads those labels and can use them to show a richer result, such as star ratings or event dates, in the search results.

Google calls these richer displays rich results. Adding structured data can enable results that are more engaging to users and may encourage them to interact more with your site, according to Google's structured data introduction.

Markup does not change what visitors see on the page. It sits in the page code, usually in a script block, and describes the content that is already visible. Google states that markup must describe the content of the page, and warns against adding structured data about information that is not visible to the user.

What are the three formats for schema markup?

Google supports three formats for structured data: JSON-LD, Microdata, and RDFa, and it recommends JSON-LD.

FormatHow it worksBest for
JSON-LDA script block in the head or body, separate from visible textMost sites, including WordPress
MicrodataHTML attributes nested inside visible contentPages where markup must sit in the content
RDFaHTML attributes that link visible content to dataSites already using linked data

All three formats are equally fine for Google, as long as the markup is valid and follows the feature documentation, according to Google's structured data introduction. JSON-LD is the easiest to add and maintain, because it sits apart from the visible text and handles nested data cleanly.

The JSON-LD format itself is defined by the JSON-LD 1.1 specification, published by the JSON for Linking Data Community Group.

A simple JSON-LD block for an article looks like this. Paste it inside a script tag of type application/ld+json:

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "What Is Schema Markup?",
  "author": { "@type": "Organization", "name": "WPLegible" }
}

Most WordPress sites never write this by hand. SEO plugins generate it from the post title, author, and publish date. Our guide on adding schema markup to WordPress shows the plugin route step by step.

What types of schema should a WordPress site use?

Use the schema type that matches each page: Article for posts, Organization for your home page, and Product for shop pages.

TypeUse it onWhat it describes
ArticleBlog posts and newsHeadline, author, publish date
OrganizationHome page or about pageName, logo, contact details
LocalBusinessBusiness home pageAddress, hours, phone number
ProductShop and product pagesName, price, stock, reviews
RecipeRecipe postsIngredients, time, calories
EventEvent pagesDate, place, ticket details
BreadcrumbListAny page with crumbsThe path back to the home page
ReviewPages with a review scoreRating, reviewer, item reviewed

Google lists the features it supports in a gallery, and each type has its own guide with required and recommended properties. You must include all the required properties for an object to be eligible for a rich result, according to Google's structured data introduction.

Pick the most specific type that fits. An online store is a subtype of Organization, and a recipe is more useful to Google as Recipe than as a plain Article. Adding markup for content that is not on the page is against Google's guidelines and can make the whole page ineligible.

Does schema markup improve rankings?

Schema markup does not directly raise rankings, but it can raise clicks by making your result more useful in search.

Google has never said structured data is a ranking signal. What it does is make a page eligible for rich results, which can show extra detail such as ratings, prices, or dates. Those details help a result stand out, and more clicks can follow.

Google publishes case studies that show the effect. Rotten Tomatoes added structured data to 100,000 unique pages and measured a 25% higher click-through rate on enhanced pages. The Food Network converted 80% of its pages and saw a 35% increase in visits.

Rakuten found users spent 1.5 times more time on pages with structured data. Nestlé measured an 82% higher click-through rate for pages shown as rich results. All four figures come from Google's structured data introduction.

No result is guaranteed. Google states that even valid markup does not guarantee a rich result will appear. Treat schema as a way to make good pages easier to understand, not as a shortcut to the top of the results.

How do you add schema markup to WordPress?

The simplest way to add schema markup to WordPress is with an SEO plugin that generates it from each post.

  1. Install an SEO plugin. Yoast SEO and Rank Math both add Article markup to posts and Organization markup to the home page by default.
  2. Fill in the site details. Add your organization name, logo, and social profiles in the plugin settings so the Organization markup is complete.
  3. Set the type per post. Choose the right type for each post, such as Article for a guide or Recipe for a recipe.
  4. Add extra types where needed. Product markup comes from WooCommerce, while event and review markup need a dedicated plugin or manual code.
  5. Test every page type. Check one post, one page, and the home page before you assume the whole site is covered.

Rank Math gives more control over individual types, while Yoast keeps the defaults simple. Our guide to Rank Math schema settings explains each option, and the Yoast SEO settings guide covers the Yoast side.

For an article specifically, see our guide on adding Article schema in WordPress. Manual JSON-LD is an option for types no plugin covers, but keep it in sync with the visible content or it will cause errors.

How do you check that your schema markup works?

Test your markup with Google's Rich Results Test during development, then watch the rich result status reports in Search Console.

The Rich Results Test is Google's free tool for validating structured data and previewing how a page may appear in search. Paste a URL or a code sample, and it lists errors and warnings for each type it finds. Fix every error before you publish.

After the page is live, check the rich result status reports in Search Console. These reports show which pages carry valid markup and which broke after deployment, for example because a theme update changed the template. Google recommends both checks in its structured data introduction.

A page can pass the test and still not show a rich result. Google decides which pages get the enhanced display, and it may skip pages that are new, thin, or low in trust. If a page is valid but shows nothing, the problem is usually the page itself, not the markup.

What mistakes should you avoid?

The most common schema mistake is marking up content that visitors cannot see on the page.

  • Hidden content: markup for facts, prices, or reviews that do not appear in the visible page.
  • Wrong type: using Product markup on a blog post, or Review markup with no real review.
  • Missing required properties: a type with no required fields is not eligible for a rich result.
  • Fake ratings: review markup for a product nobody reviewed, or scores made up by the site owner.
  • Blank pages for markup: creating empty pages only to hold structured data, which Google forbids.
  • Set and forget: theme and plugin updates can break markup, so recheck it after each major update.

Google states that supplying fewer but complete and accurate recommended properties is better than trying to provide every possible property with poor data, according to its structured data introduction. Start with one type per page, get it valid, and add more only when the content earns it.

Frequently asked questions

What is JSON-LD?

JSON-LD is a script block placed in the head or body of the page, separate from the visible text. It is the format Google recommends because it is the easiest to add and maintain. Microdata and RDFa are also supported, but they sit inside the visible HTML.

Does schema markup improve Google rankings?

No. Google has never said structured data is a ranking signal. It makes a page eligible for rich results, which can raise clicks by showing extra detail such as ratings or prices. Valid markup does not guarantee a rich result will appear.

Which schema type should I use on a blog post?

Use the type that matches the page: Article for blog posts, Organization for the home page, Product for shop pages, and Recipe for recipe posts. Pick the most specific type that fits, and never mark up content that is not visible on the page.

How do I test my schema markup?

Use Google's Rich Results Test while you build the page, then check the rich result status reports in Search Console after it is live. The test shows errors and warnings for each type, and the reports show pages whose markup broke after deployment.

Can a WordPress plugin add schema markup for me?

Yes, most SEO plugins generate it for you. Yoast SEO and Rank Math add Article markup to posts and Organization markup to the home page by default. Product markup comes from WooCommerce, while event and review markup may need a dedicated plugin.

Sources

  1. Introduction to structured data markup in Google Search Google Search Central
  2. Schema.org Schema.org
  3. Organization Schema Markup Google Search Central
  4. JSON-LD 1.1 JSON for Linking Data Community Group
  5. Rich Results Test Google Search Console Help

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.