ENATIV Logo
ENATIV
Back
© 2026 ENATIV
ProjectsServicesKnowledge hubContact
contact@enativ.pl
  1. Knowledge hub
  2. ›
  3. SEO & analytics
  4. ›
  5. Structured data (Schema.org)

Structured data (Schema.org)

Page content described in Schema.org as JSON-LD: what to mark up, what to skip, and the end of FAQ rich results.

SEO & analytics

Category
SEO & analytics

In practice

Structured data describes a page in the Schema.org vocabulary, which search engines read directly. I write it as JSON-LD, add it to every public web project as standard, and describe only what a visitor sees. It gives a page a chance at rich results; Google decides whether to show them.

What is Structured data (Schema.org)?

Schema.org is a shared vocabulary of types and properties for describing the content of pages, for example an organization or a service. An open community runs it, and Google and Microsoft are among its founders. The vocabulary does not say how to write the data down. Formats do that, among them Microdata and JSON-LD.

JSON-LD is a JSON-based syntax, and its version 1.1 is a W3C Recommendation from 2020. It goes in a script tag, apart from the visible text, so it does not mix with the HTML of the content. Google supports three formats and recommends JSON-LD, because it is the easiest to implement and maintain at scale. That is why I choose it by default.

How I approach markup

I start from what the page should communicate, and only then pick types. Markup describes content already on the page, so it is no place for things the visitor will not see.

  1. Types from visible content

    I go through the page and ask, block by block, whether the visitor sees it, and describe only such blocks. The Google guidelines require the data to be a true representation of the page content, so I add nothing hidden or inflated.

  2. Required fields and validation

    For types that have a function in Google results, I fill in the required properties of the type, because without them a page is not eligible for a rich result. Before launch I check the markup in the Rich Results Test and the Schema Markup Validator, afterwards in Search Console.

  3. One data source and safe output

    I generate the markup from the same data that produces the page content, not by hand next to it. Then a changed service name or email address does not drift from what is visible. In Next.js I also replace the less-than character with its unicode escape, because JSON.stringify does not protect against XSS injection.

When it fits, and when it doesn't

Markup makes sense where there is something to describe and someone to show it to.

A good fit when

  • A service or portfolio page where a search engine should recognize who you are and what you offer.
  • A page inside a site hierarchy, whose position can be described.
  • Articles and posts where the author and date matter.
  • A store where the product, price and availability in the markup match what the page shows.

Not a fit when

  • Content the visitor does not see: hidden text or reviews added only to the markup.
  • A type that does not fit the page, chosen because Google gives a rich result for it.
  • An expectation that markup alone will lift a ranking or that a rich result will certainly appear.
  • A site where nobody will update the markup after the content changes.

When the problem is page speed rather than the way content is interpreted, I begin with Core Web Vitals. When structured data is part of wider work on visibility, that is covered by technical SEO and the audit.

Frequently asked questions

I do not promise it. Markup lets a page qualify for rich results and does not guarantee they show. It helps a search engine understand the content, so I use it, but I do not credit it with a ranking.
Google stopped showing them in search from 7 May 2026 and later removed their documentation. The FAQPage type still exists in the Schema.org vocabulary, but it no longer earns a rich result in Google. I keep questions and answers on a page for readers, but I write no markup just to get expandable questions in results.
Sometimes. In a CMS markup can come from a plugin or settings. In WordPress a plugin usually does it, so I check its output in the Rich Results Test against the page. When it describes something the page does not show, I fix the settings or write the markup myself.
I check syntax and types in the Schema Markup Validator and eligibility for Google features in the Rich Results Test. After launch I watch the rich result reports in Search Console, because a template can break markup on some pages. A passing test does not prove the markup tells the truth about the content, so I check that myself.

On this page

  • In practice
  • What is Structured data (Schema.org)?
  • How I approach markup
  • When it fits, and when it doesn't
  • Frequently asked questions

Related topics

  • Structured data (Schema.org)
  • Core Web Vitals
  • Next.js
  • WordPress

Related services

  • SEO / PositioningTechnical SEO audits, on-page optimization, and monthly reporting to grow organic search traffic sustainably.
  • Website & AI AuditA crawlability and AI-legibility audit for your site - structured data, llms.txt, and real visibility in generative search results.

Does your page tell search engines who you are?

Tell me which page you have and whether it carries any markup yet. I will check whether it is correct and matches the content. The details are on the [[service:seo|SEO]] and [[service:audyt|audit]] pages.

Describe your project