Products SEO & GEO Agent Paid Ads Agent Website Agent Conversion Agent
How it works Pricing FAQ Blog Book a call

Schema markup: a plain-English guide for beginners

Updated · 8 min read

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 call

What 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:

TypeWhat it can show on GoogleWho needs it
OrganizationCan influence the logo shown in Search and your knowledge panelEvery business, once, on the home or About page
LocalBusiness (or a subtype like Dentist, Plumber)Business details such as hoursAnyone with an address customers visit
BreadcrumbThe page's place in your site instead of a long URL; desktop results only since January 2025Sites with more than a few pages
ArticleBetter headline, image and date displayBusinesses that publish a blog or news
ProductPrice, availability, review stars (from customers, on product pages)Anyone selling items online
EventDate, time and place of each eventClasses, workshops, open houses, shows
VideoA video thumbnail and detailsPages built around a video
Review snippetStar ratingReviews of products, books, recipes and similar; not reviews of your own business on your own site
Job postingYour opening in Google's job searchBusinesses 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.

TypeStatus
FAQPageNo longer shown since May 7, 2026; documentation removed June 15, 2026
HowToDeprecated September 13, 2023
Course info, Estimated salary, Learning video, Special announcement, Vehicle listingDocumentation removed September 9, 2025: "no longer shown in Google Search results"
Practice problemDocumentation 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)
FormatHow it worksVerdict
JSON-LDOne separate script block, usually in the page headGoogle calls it "the easiest solution for website owners to implement and maintain at scale"
MicrodataLabels added as attributes inside your visible HTMLWorks; harder to keep right as the page changes
RDFaSimilar to Microdata, different attribute namesWorks; 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:

  1. Pick the right type for the page. A service page is not a Product; a blog post is an Article.
  2. 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.
  3. Prefer a few correct facts to many shaky ones. Google says "it is more important to supply fewer but complete and accurate recommended properties."
  4. Mark up only what visitors can see. "Don't mark up content that is not visible to readers of the page."
  5. 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.

ToolWhat it answersUse it when
Rich Results Test (Google)Can this page get a Google rich result, and what's broken? Accepts a URL or pasted codeBefore 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

ErrorFix
Missing required property (the test flags it)Add the field, or remove the markup
Markup describes something not on the pageShow the fact on the page, or delete it from the markup
Stars from your own business's reviewsRemove 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 markupUpdate the markup whenever the page changes
Same markup copied onto every pageEach 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?

Keep learning

NextPermalinks and SEO: Does URL Structure Still Matter?What Google says about keywords in URLs, length, hyphens and dates, whether AI answers care, and how to change a permalink without losing traffic.

Do it yourself

Crawlability checklist: make every page reachable by GoogleA crawlability checklist for a small business site: find orphan pages, robots.txt blocks, broken links, redirect chains and server errors, with free tools.

Ask us one question

One line is enough. We reply by email.

Sources

  1. Google Search Central: Review snippet structured data
  2. Google Search Central: Introduction to structured data markup
  3. Google Search Central: General structured data guidelines
  4. Google Search Central: Structured data markup that Google Search supports (search gallery)
  5. Google Search Central: Latest documentation updates (2025–2026)
  6. Google Search Central: Optimizing your website for generative AI features on Google Search
  7. Google Search Central: Organization structured data
  8. Google Search Central Blog: Changes to HowTo and FAQ rich results (2023)
  9. Google Search Central: Speakable structured data (beta)
  10. Google Search Central Blog: The Structured Data Testing Tool update (2020, updated 2021)
  11. Schema.org: Schemas (vocabulary size)
  12. Google: Rich Results Test
  13. Schema.org: Schema Markup Validator
  14. Search Engine Roundtable: Google Again Says Schema Does Not Make Your Site Rank Better (October 2023)