What is JSON-LD?
JSON-LD (JavaScript Object Notation for Linked Data) is a format for writing structured data as a separate script block in a page, and it’s the format Google recommends.
Want to know if your site gets JSON-LD right?
I’ll check how AI search sees your business today and what would help it cite you, free.
In plain English
JSON-LD lives in a <script type="application/ld+json"> block, separate from the visible content. That makes it far easier to write and maintain than older formats like Microdata, which weave attributes through the HTML itself.
Each block names a @context (usually Schema.org) and a @type. Giving entities an @id lets you connect them, so a WebPage can say it’s about a business that’s defined once, instead of repeating every detail on every page.
Why it matters for a small business
Google can read JSON-LD that JavaScript adds after the page loads, but many other crawlers, including many AI crawlers, may not. On the sites I build, it’s rendered straight into the HTML at build time, so every crawler sees it on the first request.
An example
A Calgary dental clinic’s site uses one connected graph: a Dentist entity with an @id on the homepage, a Person for each dentist pointing back to it, and each service page referencing the clinic by that same @id. Changing the clinic’s phone number means editing one place, and every page stays consistent. (More for dental clinics.)
Common mistakes
Where I see JSON-LD go wrong most often.
Leaving a trailing comma or stray quote that makes the whole block invalid without any visible error.
Injecting JSON-LD only through Google Tag Manager, so crawlers that don’t run JavaScript never see it.
Ending up with two conflicting blocks, one from the theme and one from a plugin, that disagree about the business.
JSON-LD, answered
Either the head or the body works. What matters more is that it’s in the HTML the server sends, not added later by a script.
Yes. Several blocks are fine, as long as they describe things consistently. Connecting them with @id keeps them from contradicting each other.
Keep reading
- nick@tavro.ca
- 587-439-9994
- Calgary, Alberta