Definition
JSON-LD (JSON for Linked Data) is a lightweight syntax for serializing structured data using JSON. It's Google's recommended format for schema markup, delivered as a <script type="application/ld+json"> in the page head or body.
Why it matters
JSON-LD keeps structured data out of the rendered HTML, so schema changes never require visual rework. Easier to maintain than microdata or RDFa, easier for LLMs to parse, and cleanly separable from layout.
How we think about it
We generate JSON-LD from typed builders in src/lib/schema.ts. Never hand-written in a template. Every schema change goes through the builder so one update propagates.