JSON-LD
Structured data in a tidy script block - the format that tells search engines what a page means, and earns the rich results that follow.
- Term
- JSON-LD
- Is
- JSON for Linked Data (structured data format)
- Google's pick
- Recommended over Microdata/RDFa
- Earns
- Rich results, knowledge-graph, AI grounding
Forms & parts of speech
Definition in plain terms
JSON-LD (JavaScript Object Notation for Linked Data) is the format Google recommends for adding SCHEMA-MARKUP structured data to a page: a block of JSON, placed in a script tag, that describes the page's entities and facts in machine-readable form — this is a Product with this price and rating, this is an Article by this author, this is an Event on this date. It's how a page tells search engines (and increasingly AI systems) what it MEANS, not just what it says — and the vocabulary it speaks is Schema.org.
The mechanics
Why JSON-LD won and how it works: structured data can be expressed three ways — Microdata and RDFa (attributes woven INTO the HTML, tangled with the markup and fragile to edit) and JSON-LD (a separate, self-contained script block) — and Google explicitly recommends JSON-LD because it's decoupled from the visible HTML (you can add, edit, or generate it without touching the page's markup, and inject it via tag managers or templates cleanly). The format describes entities using Schema.org types and properties (Product, Article, FAQPage, BreadcrumbList, Organization, Event, Recipe, and the rest), and search engines use it to (1) earn RICH-RESULTS — the star ratings, prices, FAQs, breadcrumbs, and event details that make a listing visually richer and higher-CTR — (2) feed knowledge-graph and entity understanding, and (3) increasingly ground AI and generative-search answers in structured facts (the GENERATIVE-ENGINE-OPTIMIZATION relevance). The rules that govern it, because they're where teams go wrong: the structured data must match the visible page (Google's guidelines require that marked-up content actually appear on the page — marking up a rating or price that isn't visible is a violation that earns manual actions), eligibility is not a guarantee (valid markup makes you ELIGIBLE for rich results, it doesn't force them — Google decides), the supported types are specific (only certain Schema types produce rich results, and the list changes — Google deprecated some, like the FAQ and HowTo rich-result surfaces being narrowed), and validation matters (the Rich Results Test and Schema validators catch errors before they cost you). The honest framing: JSON-LD is high-leverage, low-risk SEO work — it doesn't directly boost rankings, but the rich results raise CTR, the entity clarity helps understanding, and the AI-grounding value is rising — so it's among the cleanest wins available, as long as it's accurate, matched to visible content, and validated.
When it matters
JSON-LD matters most where eligible rich-result types apply — e-commerce (Product, Offer, Review), publishers (Article, breadcrumbs), local businesses (LocalBusiness, Organization), and any page type with a supported rich result — and increasingly as the structured grounding for AI and generative search. It matters as template-scale work (one correct JSON-LD template multiplies across every product or article) and as accuracy-governed work (the match-the-visible-content rule is a manual-action risk if ignored). The discipline is Schema.org types chosen for the page's actual content, JSON-LD generated from the same data that renders the visible page (so they can't diverge), validation via the Rich Results Test before shipping, and honest expectations — eligibility not guarantee, CTR and understanding not direct ranking, with the rising AI-grounding value as the bonus.
Synonyms & antonyms
Synonyms
Antonyms
Origin & history
JSON-LD was standardized by the W3C (2014) as a way to embed Linked Data in JSON, and Google adopted it as the recommended structured-data format because its clean separation from page markup made it far easier to deploy than inline Microdata or RDFa; the rise of rich results and, lately, AI grounding turned it into core SEO infrastructure.
Etymology: source.
Usage trends
Search interest for this term over the last five years:
Common questions
- What is JSON-LD?
- JavaScript Object Notation for Linked Data — the script-block format Google recommends for structured data, describing a page's entities and facts in machine-readable Schema.org vocabulary.
- Why does Google recommend JSON-LD?
- Because it's a self-contained script block decoupled from the visible HTML — easy to add, edit, generate, and inject via tag managers without tangling with the page's markup, unlike Microdata or RDFa.
- Does JSON-LD improve rankings?
- Not directly — it makes pages eligible for rich results (raising CTR), feeds entity understanding, and grounds AI answers; the content must match what's visible, and eligibility is never a guarantee.
Related tools & calculators
Resources & people to follow
- referenceGoogle — intro to structured data (JSON-LD)
- referenceSchema.org vocabulary; Rich Results Test
- referenceRGM analysis — generate JSON-LD from the same data as the visible page; validate before shipping; eligibility, not guarantee
Curated, non-competitor resources verified per term.
Related training
- modulePerformance marketing
Disciplines
Areas of marketing where json-ld is a core concern: