Structured data says what the page says

Does the structured data say what a reader of the page sees?

Identity · 10 of 100 in Identity · yours to do · schemamatch

What we look for

For your home page’s identity in JSON-LD, and for the node that is each page we sample, your newest posts among them (the one whose @id, url, or mainEntityOfPage is the page’s address, else the page’s mainEntity, else the first node on your own site; never a third party’s node, such as an audio player’s), we take its name, headline, description, and its author’s name, and look for each in what a reader of that page sees: its text, its title, and its images’ alt text (a name set in your logo counts). We compare with case, spacing, and punctuation set aside, so “Example, Inc.” matches “example inc”, and a description cut short, mid-word or with an ellipsis, matches when the page’s text begins with it.

A description is a summary by design, so it also passes when it is the same as the page’s meta description or og:description. A value that appears nowhere on the page is a mismatch. The score is the share of the values we compared that appear, and the report names each field that didn’t, and the page it’s on. If there’s no JSON-LD to compare, the criterion is skipped; the structured identity criterion already says so.

Why it matters

Structured data is a claim about the page, made in a vocabulary AI reads without guessing. When it says something the page doesn’t, AI has to choose which to believe, and Google asks plainly that structured data match the visible content. A description written once for search and never shown, or a name the page no longer uses, makes the claim look careless at best.

How to pass

  1. Open each page the report names and read its JSON-LD next to the page.
  2. Change whichever is out of date, so the two agree: the JSON-LD’s name is the name the page shows, its headline is the page’s heading, its description says what the page says, and its author is the person the byline names.
    {
      "@context": "https://schema.org",
      "@type": "BlogPosting",
      "headline": "How we schedule a small studio",
      "description": "The three rules we use to fill a week without overbooking anyone.",
      "author": { "@type": "Person", "name": "Pat Example" }
    }

Evidence

  • Google, “AI features and your website” · December 2025 · strong

    Structured data should match the content visible on the page; Google’s AI features follow the same rules as Search.

    Vendor documentation.

Last changed .

The whole rubric