Schema markup is code that labels the parts of a page, such as a recipe, a product or an article, so that search engines understand it better. Done well, it can make a page eligible for rich results. Done badly, it can be ignored or even cause a penalty.
This guide explains what schema markup is, which format to use, how to add it step by step, and which mistakes to avoid. It follows Google’s own documentation, and it is honest about what markup cannot do.
Schema markup is structured data, usually written in JSON-LD, that describes your page in a standard way. Google can use it to show rich results, but it does not guarantee them. Add only markup that matches what visitors can see, test it with the Rich Results Test, and fix errors before you publish.
⚡ Key Takeaways
- Structured data is a standardized format for describing a page and classifying its content.
- Google says structured data can enable more engaging results called rich results.
- Google does not guarantee that your markup will show up in search, even if it passes the Rich Results Test.
- Markup must represent the main content of the page, and content it refers to must not be hidden from users.
- Most Search structured data uses schema.org vocabulary, but Google’s own documentation is the final word for Google Search.
What Is Schema Markup?
First, Google describes structured data as a standardized format for providing information about a page and classifying the page content. On a recipe page, for example, it can label the ingredients, the cooking time and the calories.
Schema.org is the shared vocabulary behind most structured data. However, Google says you should rely on its own Search Central documentation as definitive for Google Search behavior, because schema.org includes more attributes than Google uses.
Why Add Schema Markup?
Google says adding structured data can enable search results that are more engaging to users, and that might encourage them to interact more with your site. These enhanced results are called rich results.
Google’s documentation cites a case study in which Rotten Tomatoes measured a 25% higher click-through rate on pages enhanced with structured data. That is one company’s result, so treat it as an example and not as a promise. For ways to improve clicks overall, see these tips on boosting organic CTR.
Markup also helps machines understand what a page is about. Still, it is not a ranking switch, and Google says it does not guarantee any feature.
Common Types of Schema Markup
| Type | Use it for | Example content |
|---|---|---|
| Article | News, blog posts and guides | Headline, author, dates |
| Product | Product pages | Name, price, availability, reviews |
| Recipe | Recipes | Ingredients, cook time, calories |
| LocalBusiness | A business with a location | Name, address, hours |
| FAQPage | A page of questions and answers | Questions with answers |
| BreadcrumbList | Site navigation trails | Page path |
Google’s documentation lists which types and properties are required, recommended or optional for each feature. So, check it before you build. Some features have limits on who is eligible, so a type that exists in schema.org may not produce a result in Google.
Which Schema Format Should You Use?
Structured data can be written in a few formats. JSON-LD is the one Google uses in its documentation examples, and it is the easiest to maintain, because it sits in one block in the page instead of being woven through the HTML.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Schema Markup: What It Is and How to Implement It",
"datePublished": "2026-01-01",
"author": { "@type": "Person", "name": "Jane Doe" }
}
</script>The snippet above is an example only. Instead, use the real headline, date and author of your page.
How to Add Schema Markup Step by Step
- Pick the right type. Match it to what the page is. A guide is an Article. A product page is a Product.
- Write the JSON-LD. Include the required properties from Google’s documentation for that feature.
- Match the visible page. Every value in the markup must also appear on the page for visitors.
- Add it to the page. Put the script in the head or body. On a CMS, a plugin or theme setting often does this.
- Test it. Use the Rich Results Test, which Google describes as a useful tool for validating structured data.
- Monitor it. Check Search Console for errors and for how the page performs.
Google notes that if you use a CMS such as Wix, WordPress or Shopify, you might not be able to edit the HTML directly. In that case, look for a plugin or a built-in setting that adds structured data for you.
Rules Google Wants You to Follow
Google’s structured data policies say markup should represent the main content of the page. In addition, the content that the markup refers to must not be hidden from the user. Markup that is misleading or does not match the page can mean that the page loses its eligibility for rich results.
Google also says it does not guarantee that structured data will show up in search results, even when the page is marked up correctly. That is because the algorithm tailors results to the searcher, so it may choose a different feature or plain text.
Common Schema Markup Mistakes
- Marking up content that is not visible on the page.
- Copying markup from another site without changing the details.
- Leaving out required properties, so the page is not eligible.
- Adding review or rating markup for content that is not a real review.
- Letting markup go stale after prices, dates or hours change.
- Expecting markup to improve rankings by itself.
For a deeper check on newer uses, this schema markup checklist goes through common checks.
Worked Example (Made-Up)
Imagine a local bakery with a page for its sourdough class. The owner adds an Event-style block with the class name, date and price, all taken from the visible text. Next, the owner tests the page in the Rich Results Test and fixes one missing property.
Two weeks later, the page is still shown as a normal result. However, that is a fair outcome, because Google does not guarantee a rich result. The markup is still accurate, and it is ready if Google chooses to use it. This bakery is made up.
Schema Markup Checklist
- Choose the type that fits the page.
- Include the required properties from Google’s documentation.
- Make every marked-up value visible on the page.
- Test with the Rich Results Test before you publish.
- Check Search Console for errors after launch.
- Update markup whenever the page details change.
Conclusion
Schema markup works best as an honest description of your page. Pick the right type, use JSON-LD, match the visible text and test it. After that, keep it current, and do not count on a rich result.
For a wider review of crawling, indexing and markup, technical SEO work usually looks at all three together.
Frequently Asked Questions About Schema Markup
What is schema markup?
It is structured data that labels the parts of a page in a standard format, so search engines can understand it. Most of it uses the schema.org vocabulary.
Does schema markup improve rankings?
Google presents structured data as a way to enable rich results, not as a ranking switch. It does not guarantee that any feature will appear.
Which format is best for schema markup?
Google’s examples use JSON-LD, which keeps the markup in one block and is easy to maintain.
How do I test my schema markup?
Use Google’s Rich Results Test. Then watch Search Console for errors after launch.
Can I add schema markup in WordPress?
Yes. Google notes that CMS users may not be able to edit the HTML directly, so a plugin or built-in setting that outputs structured data is the usual route.
