Schema.org completeness: what the check tests and how to fix it

Averages how many of 7 fixed fields (name, description, author, dates, image, url) the first JSON-LD block has. 70% passes. It is not type-aware.

Structured Data · Weight 1 in the w2agent Score

How common is it?

1% of 1223 measured sites where this check applied pass.

Latest audit of each site under rubric v3.1. Sites where the check did not apply or could not be measured (for example, no llms.txt for the llms.txt checks) are left out. A partial result does not count as a pass.

What this check tests

Only pages that have at least one parseable JSON-LD block are looked at (see Schema.org JSON-LD present). Pages with none are left out of this average, so a site with markup on one page can score well here and badly on the presence check.

For each such page the audit takes the first block only and checks whether these seven top-level keys exist: name, description, author, datePublished, dateModified, image and url. A key counts if it is present with any value, including an empty string. Nothing is checked about the value. The page's score is the fields present divided by seven; the check averages that over the pages with markup and rounds.

  • Pass: the average is 70 or more. That means five of seven fields on a typical page (5 of 7 is 71).
  • Partial: above 0 but under 70.
  • Fail: 0. This includes the case where no page has JSON-LD, with the message "No Schema.org data to evaluate".

The list is the same for every type. Two things follow. Fields are read only at the top level of the first block, so a block that wraps its nodes in @graph scores 0 for that page. And the list mixes fields from different schema.org types: name, description, image and url are defined on Thing, while author, datePublished and dateModified come from CreativeWork. The list is oriented to articles and pages, so blocks of other types such as Organization or Product typically fill fewer of the seven. That is not an enforced cap: the audit counts the listed keys on any type, so a single block that has five of them passes. Article-like pages are what this check is built for.

Why it matters to agents

Descriptive fields are what a parser gets out of a block. A name, a description, an author and a date let a tool say what a page is, who wrote it and how fresh it is without reading the whole body. That is general good practice for structured data.

Google's guidelines make a related but different point: items that are missing required properties are not eligible for rich results, and the more recommended properties you give, the higher quality the result is for users. Required and recommended properties are set per feature in Google's documentation, not by the fixed list used here. Google also says its AI features need no special schema.org markup, so do not expect a direct effect on chat answers from raising this number.

How to fix it

  1. On article-like pages (posts, guides, docs), make the first block carry all seven keys: a headline or name, a description, an author object, datePublished, dateModified, an image URL and the page url. Note that this check wants name, not headline; schema.org has both, so include name as well.
  2. Put the page's main block first in the HTML. Only the first block is read, so a small WebSite or BreadcrumbList block placed above it will be the one that is scored.
  3. Fill the values from your CMS fields, not by hand, so dates stay current. Update dateModified when the page changes.
  4. For Organization, Product and similar pages, expect a partial. Fill the four fields that exist for the type and do not invent an author or a publication date. Schema.org defines author and datePublished on CreativeWork, so adding them to a company profile would be false markup.
  5. Keep the values true to the visible page. Google's guidelines say not to mark up content that readers cannot see.

Choosing types is covered by Appropriate Schema.org type, and whether @context and @type are well formed by JSON-LD valid.

Examples from measured sites

Up to 10 of the highest-scoring sites in each group, from recent audits. Failing includes partial results.

Passing

Failing or partial

Sources

Verified against these sources on

Does your site pass this check?

Check your own site →