Skip to content

Structured data

machine-readable details in the source code

Additional details in the source code that tell a machine what your information means — that 6 p.m. is a closing time and not just some number.

  1. Mark up the details in the source code
  2. Search engine reads them out by machine
  3. Meaning instead of mere text
  4. An enhanced display becomes possible

What does Structured data mean?

A person reading "Monday to Friday, 8 a.m. to 6 p.m." on your website knows at once what is meant. A machine at first sees only text. Structured data is the addition that turns text into a statement: an opening time starts here, that is a company name, that a postal address, that a price, that a question with its matching answer.

Technically this addition sits in a block of its own in the source code, usually in a format called JSON-LD, and is invisible to visitors. The vocabulary for it is called Schema.org and has been maintained jointly since 2011 by four search engine operators — Google, Microsoft, Yahoo and Yandex. It is therefore not a Google creation but a shared language that other systems read too.

The visible benefit shows up in the search result. A plain listing can turn into an enhanced result: with opening hours, with expandable questions, with an image, with a price range, with an event date. Such results take up more space on the search results page and are therefore noticed more often — which, however, is not a promise but a possibility.

Precisely that limitation belongs here, because it is often left unsaid: structured data is not a ranking factor and no guarantee of an enhanced display. Google decides for each query whether it shows the additional details. What you can do is create the precondition; whether it is used is for the search engine to determine.

The second benefit is by now almost the more important one. Language models and AI answers have to extract from a page which statement belongs to which thing. A page that supplies its details marked up is easier for a machine to understand correctly than one that says the same thing only in prose. That is part of what we mean by AI visibility.

For most businesses a few types from the large vocabulary are enough. A description of the company with address, area and hours. Markup of the questions and answers, where there are any. Markup of the navigation path, so the search engine sees where a page hangs in the structure. For hotels and restaurants, details about the property are added; for law firms, rather the assignment of practice areas.

One rule stands above all others: only what is also visible on the page may be marked up. Review stars without genuine reviews, prices that do not exist in that form, or opening hours nobody keeps — that is not merely a breach of the guidelines leading to the loss of the enhanced display. It is at the same time a misleading statement towards consumers, and stating reviews without a verifiable basis is expressly prohibited.

The result can be checked free of charge. Google provides a test for enhanced results, and the Search Console shows for your own domain which markup was recognised and where faults sit. We set the details so that they match the visible content, and then measure against the delivered source code, not against the template — what is in the file is not always what arrives. On multilingual websites we check every language version individually, because markup there has been known to run only in the original language.

Check the numbers

The Schema.org vocabulary has been maintained jointly since 2011 by four search engine operators: Google, Microsoft, Yahoo and Yandex.

That is why the effort is not tied to a single search engine. Anyone marking up their details according to this vocabulary supplies them in a form several systems can read — and increasingly language models too, which assemble answers from websites. A promise of an enhanced display expressly does not follow from this: whether the additional details are shown is decided by the respective search engine for each query.

Source: schema.org, information on the founding and sponsorship of the vocabulary; Google Search Central, documentation on structured data.

Common questions

Does structured data improve my ranking?

No, it is not a ranking factor. It can, however, mean that your listing in the search result gets more space and more substance — and it makes your details unambiguous for machines. Both act on the click, not on the position.

May I mark up review stars if I do not have any reviews yet?

No. Without genuine, verifiable reviews the statement is misleading and at the same time a breach of the guidelines for enhanced results. Only what is visibly on the page and true may be marked up.

A term missing? Send it to us

We explain every term calmly and without tech-speak — and tell you honestly what makes sense for you and what doesn't.

ProvenExpert