Schema markup: a plain-English guide for beginners
Short answer Schema markup is hidden code that labels the facts on a page, like a name, price, date or address, using the schema.org vocabulary. It doesn't raise rankings. It makes a page eligible for rich results such as breadcrumbs, event dates or product prices. Use JSON-LD, mark up only what visitors see, and test it with Google's Rich Results Test.
Want help applying this to your business? Talk it through on a free 30-minute call.
Book a callWhat is schema markup?
Schema markup is a small block of code on a page that tells search engines what each fact means. A visitor sees "Saturday, 10 am, 42 Main St." Schema tells Google that this is an event, that the time is its start time, and that the address is its location. Visitors never see the code.
Google calls it structured data:
"Structured data is a standardized format for providing information about a page and classifying the page content." (Google Search Central: Introduction to structured data markup)
"Schema" comes from schema.org, the shared dictionary of labels that Google, Bing and others read. Google says "most Search structured data uses schema.org vocabulary." The dictionary is large: schema.org lists 826 types and 1,540 properties as of November 2026. A type is the kind of thing (Event, Product, Plumber). A property is one fact about it (startDate, price, telephone). You need only a handful.
Does schema markup help SEO?
It changes how your listing can look, not where it ranks. Google's Search Liaison wrote on X in October 2023 that "using schema doesn't give you a ranking boost," as reported by Search Engine Roundtable.
What it does: it makes a page eligible for a rich result, a search listing with extras such as a price, a date or a breadcrumb trail. Eligible is not promised: "Google does not guarantee that your structured data will show up in search results," say Google's general structured data guidelines.
When rich results do show, case studies in Google's introduction to structured data report gains: Nestlé measured an 82% higher click-through rate on pages shown as rich results, and Food Network saw 35% more visits after enabling search features on 80% of its pages. Those are big brands, chosen by Google; treat them as possible, not typical.
For what schema does for a local business's Google listing and AI answers, see local business schema markup.
Which schema types matter for a small business?
Only types listed in Google's search gallery can produce a rich result. For most owners, these are the ones worth adding:
| Type | What it can show on Google | Who needs it |
|---|---|---|
| Organization | Can influence the logo shown in Search and your knowledge panel | Every business, once, on the home or About page |
| LocalBusiness (or a subtype like Dentist, Plumber) | Business details such as hours | Anyone with an address customers visit |
| Breadcrumb | The page's place in your site instead of a long URL; desktop results only since January 2025 | Sites with more than a few pages |
| Article | Better headline, image and date display | Businesses that publish a blog or news |
| Product | Price, availability, review stars (from customers, on product pages) | Anyone selling items online |
| Event | Date, time and place of each event | Classes, workshops, open houses, shows |
| Video | A video thumbnail and details | Pages built around a video |
| Review snippet | Star rating | Reviews of products, books, recipes and similar; not reviews of your own business on your own site |
| Job posting | Your opening in Google's job search | Businesses hiring |
Schema types Google no longer shows
Plenty of tools still add markup that Google has stopped showing. Dates are from Google Search Central's documentation changelog and its 2023 HowTo and FAQ announcement. It does no harm, but it earns nothing on Google.
| Type | Status |
|---|---|
| FAQPage | No longer shown since May 7, 2026; documentation removed June 15, 2026 |
| HowTo | Deprecated September 13, 2023 |
| Course info, Estimated salary, Learning video, Special announcement, Vehicle listing | Documentation removed September 9, 2025: "no longer shown in Google Search results" |
| Practice problem | Documentation removed January 6, 2026; no longer shown |
JSON-LD, Microdata or RDFa?
Use JSON-LD. All three formats say the same thing in different ways, and Google reads all three, but:
"In general, Google recommends using JSON-LD for structured data if your site's setup allows it." (Google Search Central: Introduction to structured data markup)
| Format | How it works | Verdict |
|---|---|---|
| JSON-LD | One separate script block, usually in the page head | Google calls it "the easiest solution for website owners to implement and maintain at scale" |
| Microdata | Labels added as attributes inside your visible HTML | Works; harder to keep right as the page changes |
| RDFa | Similar to Microdata, different attribute names | Works; rarely worth choosing |
How do I add schema markup to my website?
Most owners never write the code. On Wix, WordPress or Shopify, Google notes your CMS "may have a search engine settings page, or you may be able to install a plugin." A web developer can also paste a JSON-LD block into the page template.
Whichever way, follow Google's rules, from its introduction to structured data and its general guidelines:
- Pick the right type for the page. A service page is not a Product; a blog post is an Article.
- Fill every required property. "You must include all the required properties for an object to be eligible." Each feature's page in the search gallery lists them.
- Prefer a few correct facts to many shaky ones. Google says "it is more important to supply fewer but complete and accurate recommended properties."
- Mark up only what visitors can see. "Don't mark up content that is not visible to readers of the page."
- Keep it true. "Your structured data must be a true representation of the page content." Change a price or hours on the page, change the markup too.
How do I test schema markup?
Use two free tools, then watch Search Console. Each answers a different question.
| Tool | What it answers | Use it when |
|---|---|---|
| Rich Results Test (Google) | Can this page get a Google rich result, and what's broken? Accepts a URL or pasted code | Before and after publishing |
| Schema Markup Validator (schema.org) | Is the code valid schema.org, including types Google doesn't use? | Checking types outside Google's gallery |
| Search Console rich result reports and URL Inspection (Google) | Did Google find the markup on live pages, and are errors appearing over time? | Ongoing, after launch |
The validator used to be Google's Structured Data Testing Tool. Google moved it to schema.org in 2021 and, on the Google Search Central Blog, gave its purpose as "to check syntax and compliance of markup with schema.org standards." For Google Search itself, the same post points to the Rich Results Test and Search Console. How to read Search Console is in Google Search Console for a small business.
Common schema markup errors
| Error | Fix |
|---|---|
| Missing required property (the test flags it) | Add the field, or remove the markup |
| Markup describes something not on the page | Show the fact on the page, or delete it from the markup |
| Stars from your own business's reviews | Remove them; Google's review snippet rules make a business's own LocalBusiness or Organization pages ineligible for stars from reviews it controls |
| Old price, hours or dates in the markup | Update the markup whenever the page changes |
| Same markup copied onto every page | Each page describes its own content; Organization goes on one page |
Misleading markup can earn a manual action. It removes rich results but "doesn't affect how the page ranks in Google web search," per Google's general guidelines. Fixing one: Google manual action.
Does schema help with voice search and AI?
Less than often claimed. Google's only voice markup, speakable, is in beta, for English news publishers, for "users in the U.S. that have Google Home devices set to English," per Google Search Central. For AI answers:
"Structured data isn't required for generative AI search, and there's no special schema.org markup you need to add." (Google Search Central: Optimizing your website for generative AI features on Google Search)
Google still advises using it, since it "helps with being eligible for rich results on Google Search."
Example
Illustrative cases, not client results.
A yoga studio with weekly workshops
It adds Event markup to each workshop page: name, start date, location, ticket price. The Rich Results Test passes. Workshops can now show with dates in Google results. When a workshop is cancelled, the page and markup come down together.
An online shop selling $40 candles
Product markup on each product page with price, currency, availability and customer ratings. Organization markup with the logo on the home page. Its old plugin also added FAQPage markup everywhere; it stays, but nobody expects it to show.
A bookkeeper's 10-page site
Organization on the home page, AccountingService on the contact page, Breadcrumb sitewide through the CMS's SEO plugin. Ten minutes in the Rich Results Test, then a monthly look at Search Console's reports.
FAQ
Is schema markup the same as structured data?
In everyday use, yes. Structured data is the idea; schema.org is the vocabulary most of it uses.
Do I need a developer to add schema markup?
Usually not. Many website builders and SEO plugins add common markup from settings you fill in. Custom types or hand-built sites need a developer.
How long until rich results appear?
Not until Google recrawls the page, and even then it isn't guaranteed. Search Console's URL Inspection shows whether Google has seen the markup.
Should I remove old FAQ markup?
No need. Google no longer shows FAQ rich results, but the markup does no harm. Keep the visible FAQ if it helps visitors.
Different for you?
- You run a local business with an address or service area: local business schema markup
- You want to win the answer box above the results: featured snippets and zero-click searches
- Search Console shows structured data errors: Google Search Console for a small business
- You got a structured data manual action: Google manual action
- You'd rather have markup checked and kept current for you: SEO & GEO Agent