Skip to content
mirok

Structured data (JSON-LD)

Structured data is information added to a page's code, using the schema.org vocabulary, to describe its content explicitly to search engines: an organization, an article, a product, an event. JSON-LD is the format Google recommends for writing it, in a script tag kept separate from the visible HTML.

Why is structured data useful?

An engine has to guess a lot when reading a page: who published it, which product it covers, what it costs. Structured data removes the ambiguity. It makes some pages eligible for rich results (reviews, prices, breadcrumbs, events) and helps engines connect your site to an identified entity.

For AI visibility its role is less direct but real: consistent, machine-readable information about your organization, products and authors makes your brand easier to understand. Stay cautious though: AI companies do not publicly detail how they use this markup.

The rules change: in 2023, for example, Google restricted FAQ rich results to certain authoritative sites. The markup stays valid, but its visible effect depends on the engine's choices.

How do you add structured data to your site?

  1. 1Start with the basics: Organization (or LocalBusiness) on the homepage, WebSite, BreadcrumbList on deeper pages.
  2. 2Add types that match your content: Article or BlogPosting, Product with Offer, Event, FAQPage if a real FAQ is visible.
  3. 3Write them as JSON-LD in a script type="application/ld+json" tag, rendered on the server so it is present in the initial HTML.
  4. 4Link nodes together with @id (the article points to the publishing organization).
  5. 5Validate with Google's Rich Results Test and the schema.org validator.
  6. 6Watch the Enhancements reports in Search Console to catch errors after each deployment.

What structured data mistakes should you avoid?

  • Marking up information that is not on the visible page: it breaks Google's guidelines and can lead to a manual action.
  • Copying another site's markup without adapting the values.
  • Injecting JSON-LD only on the client, after JavaScript runs.
  • Adding invented reviews or ratings to get stars.