Search · Term

Structured data

Structured data is standardised, machine-readable markup added to a page that describes what its content means — for example, that it is an article, a product, or an FAQ.

Most structured data on the web follows the schema.org vocabulary, usually in JSON-LD. It helps search engines produce rich results and helps AI engines correctly identify and use your content — a small, high-leverage part of both SEO and GEO.

How it works

Structured data can be written as JSON-LD, Microdata or RDFa; JSON-LD, a separate script block, is the format Google recommends because it does not have to be woven into the visible HTML. Each block declares a type from the schema.org vocabulary and properties describing the page's content. Google's Rich Results Test and Search Console report whether it is valid and eligible for enhanced results.

Eligibility is not a guarantee: engines decide per query whether to show a rich result.

Example

An article page can declare its headline, author, publication and modified dates, and a breadcrumb trail. Search Console then reports the breadcrumbs as detected, and the result can show a path like "troiana.net › Insights" instead of a bare URL.

In practice

Ask your developer where the structured data on your site comes from: the CMS, a plugin, a theme or code written for the site. Each source can be fine, but two sources describing the same page differently is a common problem, so check a few pages in Google's Rich Results Test and look for duplicates. Then check that the values are pulled from the same place as the visible content, so changing a price, an event date or opening hours updates both at once.

Edge cases deserve a thought. A business with several locations needs each described separately with its own address and hours, not one combined entry. Seasonal hours and holidays should be updated in the markup as well as on the page and in your business profile. Reviews are a frequent source of trouble: marking up reviews of your own business on your own site does not produce star ratings in Google and can look misleading. After launch, the enhancement reports in Search Console show errors across the site, which is often the first sign that a template change broke something.

Why it matters for your business

Structured data reduces the chance that machines misread the facts that bring in customers: your opening hours, prices, event dates, address and the author behind your advice. Those facts feed search results and the AI answers that summarise them, and when they match your Google Business Profile, engines have one consistent story to repeat. It can also make pages eligible for rich results. The effort is small when it is generated by your page templates, but stale markup is worse than none, because it publishes outdated facts in a format machines trust. Whoever updates prices or hours should know the markup must change with them.

Common mistakes

  • Describing content in the markup that visitors cannot see on the page.
  • Leaving dates hard-coded so the markup says a page was last modified months ago.
  • Relying on markup types, such as FAQ, whose rich results Google has withdrawn.

Questions people ask

Can structured data hurt my website?

Invalid markup is usually just ignored. Misleading markup is different: describing content visitors cannot see, inventing reviews or marking up something the page does not offer can lead Google to remove rich results or take manual action against the site. Keep the markup an honest description of what is on the page.

Do AI engines read structured data?

Many crawlers parse JSON-LD, and it helps them identify what a page is and who published it. The extent to which each AI engine uses it is not fully documented, and visible text remains the main source for their answers. Treat structured data as a clear supporting signal, not a substitute for well-written pages.

Do I need a developer to add structured data?

Not always. Many CMS platforms and SEO plugins add basic markup, such as Organization, Article and breadcrumbs, automatically. Custom types, such as services, events, menus or courses, or a site-wide connected graph, usually need a developer, ideally building it into templates so it updates whenever the content changes.

Read: How to add JSON-LD structured data to any page →

Related terms

Have something worth building right?