JSON-LD structured data - MetricSpot docs

What this check does

Parses your page’s HTML for <script type="application/ld+json"> blocks. Counts how many you have and inspects whether they’re valid JSON.

Why it matters

Structured data turns your page from “a wall of text” into “a typed object with fields.” Three downstream benefits:

Rich results in Google. Recipes show star ratings, products show prices, articles show author and publish date. Without JSON-LD, your search result is plain blue links.
AI citation accuracy. LLM agents extract entities (people, products, organizations) from JSON-LD with near-perfect accuracy. Without it, they have to guess from prose.
Knowledge Graph. Google’s Knowledge Graph (the right-side panel for entities) is largely built from structured data. Organizations with strong schema get featured; those without don’t.

How to fix it

Add a JSON-LD block in the <head> of every page. At minimum, every site should have an Organization schema sitewide and per-page-type schema on each page.

Sitewide Organization (in your global layout):

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "MetricSpot",
  "url": "https://metricspot.com",
  "logo": "https://metricspot.com/logo.png",
  "sameAs": [
    "https://x.com/metricspot",
    "https://linkedin.com/company/metricspot"
  ]
}
</script>

Per-page (an article):

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to write a meta description that ranks",
  "author": { "@type": "Person", "name": "Alex Diaz" },
  "datePublished": "2026-05-11",
  "image": "https://metricspot.com/og/article.png"
}
</script>

Common types: Article, BlogPosting, Product, FAQPage, HowTo, Recipe, LocalBusiness, Event, Course, SoftwareApplication.

Validate with Google’s Rich Results Test before deploying. Schema errors don’t break your site, but they silently disable rich results.

Frequently asked questions

Microdata or RDFa instead of JSON-LD?

JSON-LD is Google’s recommended format and the only one all major AI crawlers parse well. Microdata and RDFa work but are deprecated for new sites.

How many JSON-LD blocks should a page have?

Two to four is normal. Sitewide (Organization, WebSite), plus per-page (Article, Product, FAQPage), plus a Breadcrumb. Don’t pad with irrelevant schemas — Google deprioritizes pages with spammy schema.

Does schema directly improve rankings?

Not directly — Google has been explicit on this. What it does is unlock rich results, which dramatically improve CTR from search, which feeds back into rankings.