SEO

Schema.org

Also called schema vocabulary

The shared vocabulary of types and properties that websites use to describe things in machine-readable form.

Quick facts: Schema.org

Category
SEO
Also called
schema vocabulary
Level
Beginner
Affects
Rich result eligibility, entity understanding, how AI answers read a page
Where to see it
schema.org, Schema Markup Validator, Rich Results Test, Google Search Console
In this article4
  1. How Schema.org works
  2. Why Schema.org matters
  3. Common mistakes with Schema.org
  4. How to act on it

How Schema.org works

Schema.org is a shared vocabulary, agreed between the major search engines and maintained as an open project, that gives web pages an agreed set of words for describing things. It defines types — Product, Recipe, Event, LocalBusiness, Person — and the properties each type can carry, such as a name, an address, a start date or an author.

The types sit in a hierarchy. Everything descends from Thing, which branches into broad categories such as CreativeWork and Organization, which branch again into narrower ones. A subtype inherits its parent’s properties and adds its own, which is why a NewsArticle can use everything an Article can use and a little more besides.

The distinction that trips people up is vocabulary versus syntax. Schema.org supplies the words; JSON-LD, microdata and RDFa are three ways of writing them into a page. Choosing JSON-LD does not mean you are not using Schema.org — it means you are writing Schema.org terms in JSON-LD.

Why Schema.org matters

Without an agreed vocabulary, every site would describe its opening hours in its own words and no machine could read any of it reliably. The shared list is what lets a search engine turn a page into facts it can act on: this is a product, that is its price, this business is that one over there with the same phone number.

That matters more as answers move away from a plain list of links. Whether the destination is a rich result, a knowledge panel or an AI-generated summary, an unambiguous description of what a page is about gives the machine less to guess at. It is not a ranking factor in itself, and nobody should sell it as one — it is a comprehension aid that sometimes earns a more visible result.

Common mistakes with Schema.org

The biggest is assuming that everything in the vocabulary does something. Schema.org is far larger than the slice any search engine actually uses, and publishing an obscure type will not produce a search feature simply because the type exists. Search engines publish their own list of supported structured data features, and that list, not the vocabulary, decides what can appear.

The other common error is marking up claims the page does not make. The vocabulary lets you assert almost anything, so it is easy to describe a product, a rating or an event that no visitor can find on the page. That is a guidelines problem, not a technical one, and it is the version of the mistake that gets sites into trouble.

How to act on it

Start from the page, not from the vocabulary. Decide what the page genuinely is — a service page, an article, a shop listing, a business profile — then find the type that matches and fill in only the properties the page really supports. Leave the rest empty rather than inventing values to look complete.

Validate with the Schema Markup Validator for vocabulary correctness and the Rich Results Test for search eligibility, because the two answer different questions. Then watch the enhancement reports in Google Search Console over the following weeks, since that is where errors on live pages surface. Where the markup is doing real work — an ecommerce catalogue, a multi-location business — it is worth planning it deliberately rather than accepting whatever a plugin emits, which is the point of proper schema markup work on a site.

Do and do not

Do

  • Pick the type that matches what the page actually is
  • Check search engine support before adopting an unusual type
  • Fill only the properties the visible page supports

Do not

  • Assume every vocabulary type produces a search feature
  • Describe products, ratings or events the page lacks
  • Sell structured data as a ranking factor

Questions people ask about this

Is Schema.org the same thing as structured data?

Not quite. Structured data is the general idea of describing a page in a machine-readable way; Schema.org is the specific vocabulary almost everyone uses to do it. There are other vocabularies for specialist fields, but for commercial websites and search engines, Schema.org terms written as JSON-LD is the standard combination.

Does adding Schema.org markup improve rankings?

Not directly. It helps a search engine understand what a page is and can make the result more prominent when the page qualifies for a rich result, and a better-looking result can earn more clicks. Treat it as a comprehension and presentation gain rather than a ranking lever, and be wary of anyone who sells it as one.

Who controls the Schema.org vocabulary?

It began as a joint effort by the major search engines and is now run as an open community project, with proposals and changes discussed publicly. That is why the vocabulary keeps growing while search engine support does not grow at the same pace. A term existing in the vocabulary is never a promise that any engine uses it.

Related terms

Found this useful?

Share it, or ask an AI to summarise it

Back to the glossary

Knowing the term is the easy part

Applying it to your own site and budget is the work. Book a call and I will tell you what actually applies to you.