Skip to content
Web Design & Development

Structured Data for Websites: What Actually Works

Machine-readable markup, usually JSON-LD, that tells search engines what a page is about in terms they already understand: an organization, an article, a product, an event.

Marcus Adeyemi Technical Director 2 min read 23 views
Structured Data for Websites: What Actually Works

Where most projects go wrong

The usual mistakes:

  • Marking up content that is not visible on the page
  • Review or FAQ markup that does not reflect genuine content
  • Hand-maintained markup that drifts from the page it describes
  • Assuming valid markup entitles you to a rich result

What good looks like instead

  • Mark up the types that match the page rather than everything available
  • Keep the markup generated from the same data the page renders
  • Validate before publishing and monitor the enhancement reports afterward
  • Include the properties a rich result actually requires
  • Use Organization and BreadcrumbList site-wide as a baseline
What to do and what to avoid with structured data for websites, side by side
Good practice against the usual mistakes, from the sources listed below.

Why it matters

It is how a page becomes eligible for rich results, and it is one of the few SEO measures that is unambiguously specified rather than inferred from observation.

The specs that matter

Published figures for Structured Data for Websites
MeasureFigure
Recommended formatJSON-LD
Vocabularyschema.org types and properties
Eligibilityvalid markup makes a rich result possible, never guaranteed
Consistency requirementthe markup must describe what is visibly on the page
Validationthe Rich Results Test and Search Console enhancement reports

Knowing when to hand it over

Tip: Bring in help when Search Console reports structured data errors at scale, when a rich result has been lost, or when a manual action has been applied for spammy markup.

Where this comes from

The figures and practices above come from the sources listed.

Working on something like this?

We take on Web Design & Development work for teams who want it done once, properly. Tell us what you are building and we will tell you honestly whether we are the right studio for it. Start a project.

Where to go next

Spotted something wrong? Report an error on this page. We correct on the page and say what changed.

All services

The work behind this article, and what it costs.

Marcus Adeyemi

Builds and maintains the web work. Writes about front-end architecture, performance, accessibility and the unglamorous parts of keeping a site alive.

Keep reading

More in Web Design & Development