Schema markup is a set of hidden labels, usually written in JSON-LD, that tells search engines and AI systems exactly what a page is about: this is a product, this is its price, this is the company behind it. It does not change what visitors see, but it helps machines read your content without guessing. Here is what schema markup is, why it matters, and how to add it without breaking anything.
What is schema markup, in plain English?
A web page is written for people. A human can glance at a product page and understand the name, the price, whether it is in stock and who sells it. A crawler sees a mass of HTML and has to infer all of that. Schema markup removes the guesswork by stating those facts in a structured, standard vocabulary.
That vocabulary lives at schema.org, a shared project started by the major search engines. It defines types such as Organization, LocalBusiness, Product, Article, Event and FAQPage, each with properties like name, address, price or author. When you mark up a page, you are filling in those properties for the things on it.
JSON-LD, Microdata and RDFa: which format to use
There are three ways to add schema markup to a page. Microdata and RDFa add attributes directly to your visible HTML tags. JSON-LD is a separate block of code, usually placed in the page head, that describes the page in a self-contained object.
Google recommends JSON-LD, and it is what we use on almost every project. It is easier to maintain because it does not tangle with your design markup, it can be generated by your CMS or a plugin, and it can be tested on its own. If a theme redesign changes every template, your JSON-LD keeps working.
Why schema markup matters for search
Schema markup is not a direct ranking factor in the sense of “add it and climb ten places”. Its value is clarity, and clarity pays off in a few concrete ways.
Rich results
Structured data makes pages eligible for rich results: review stars on products, prices and availability, event dates, recipe details, breadcrumbs and more. These richer listings take up more space and tell searchers more before they click. Eligibility is not a guarantee; Google decides when to show them, and the markup must match content that is actually visible on the page.
Entity understanding
Organization and LocalBusiness markup connect your website to your brand as an entity: your official name, logo, address, contact details and social profiles. That helps search engines join the dots between your site, your Google Business Profile and mentions of you elsewhere on the web.
AI answers and citations
AI assistants and AI Overviews draw on pages they can understand confidently. Nobody outside those companies can promise that schema markup earns a citation, and anyone who does is overselling. What structured data does is make your facts unambiguous: who you are, what you offer, what it costs and where you operate. Unambiguous facts are easier to quote. That is why schema is part of every AI search optimisation project we run.
The schema types most business sites need
You do not need to mark up everything. For a typical business website, a short list covers most of the value:
- Organization on the home page: legal name, logo, URL, contact points and sameAs links to official profiles.
- LocalBusiness (or a more specific subtype) if customers visit a physical location: address, opening hours, geo-coordinates.
- WebSite with the site name, which helps search engines show the right name in results.
- BreadcrumbList on inner pages, reflecting your real navigation.
- Article or BlogPosting on posts, with author, publish date and modified date.
- Product and Offer on e-commerce pages, with price, currency and availability.
- Service on service pages, describing what you provide and where.
If you sell in several countries, add the details that matter in each: currency on offers, area served on services, and the right address and phone number on each location page. A business with offices in Dhaka and Dubai, for example, should describe each office as its own LocalBusiness rather than merging them into one confusing entry.
Link these together with consistent @id values so they form a single graph. An Article’s publisher should point to the same Organization defined on your home page, rather than repeating a slightly different version of your company on every page.
Common schema markup mistakes
Most schema problems we find in audits come from a handful of habits:
- Marking up content that is not on the page. If the FAQ or the review is not visible to visitors, it should not be in the markup. This can lead to manual actions.
- Self-serving reviews. Google does not show review stars for reviews a business publishes about itself on its own Organization or LocalBusiness markup.
- Chasing retired features. Google limited FAQ rich results to a small set of authoritative government and health sites in 2023 and stopped showing HowTo rich results. FAQPage markup can still help machines understand a page, but do not expect the old expandable listings.
- Conflicting plugins. An SEO plugin, a theme and a review plugin can each output their own Organization, producing three different versions of your company.
- Stale data. Prices, opening hours and availability in markup that no longer match the page.
How to add and test schema markup
On WordPress, a good SEO plugin or a custom theme can generate most of the core markup automatically from the content you already edit. For custom builds, we generate JSON-LD from the same data that renders the page, so the two can never drift apart. If you want to hand-write a block for a single page, our free schema markup generator produces valid JSON-LD you can paste in.
Then test. Google’s Rich Results Test shows which rich results a page is eligible for and flags errors. The Schema Markup Validator checks syntax against the full schema.org vocabulary. After launch, the enhancement reports in Google Search Console show errors and warnings across the whole site, which is where you catch the template-level problems that a single-page test misses.
Good schema markup says nothing new. It states, in a format machines can read, exactly what the page already tells a human.
Is schema markup worth the effort?
For most business sites, yes, and the effort is smaller than people expect. The core types take a few hours to set up properly and then run on their own. The payoff is cleaner listings, better entity understanding and content that AI systems can quote with confidence. The cost of skipping it is quieter: competitors with richer results and clearer facts look more credible next to you.
Treat schema as part of technical SEO, not as a one-off trick. Review it when you redesign, when you add new page types and whenever your business details change.
Key takeaways
- Schema markup labels the facts on a page in the standard schema.org vocabulary.
- Use JSON-LD; it is Google’s recommended format and the easiest to maintain.
- It enables rich results and clearer entity understanding, but it is not a guaranteed ranking or citation boost.
- Start with Organization, WebSite, BreadcrumbList, Article and, where relevant, LocalBusiness, Product and Service.
- Only mark up what visitors can see, and test with the Rich Results Test and Search Console.
Not sure whether your site’s structured data is helping or hurting? Xenishio Arc audits and fixes schema markup as part of our SEO and AI search work for teams in the US, UK, UAE and Bangladesh. Get in touch and we will check your key templates.