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.

No newsletter. Just what you asked for, from me. Privacy

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.

  1. Leaving a trailing comma or stray quote that makes the whole block invalid without any visible error.

  2. Injecting JSON-LD only through Google Tag Manager, so crawlers that don’t run JavaScript never see it.

  3. Ending up with two conflicting blocks, one from the theme and one from a plugin, that disagree about the business.

FAQ

JSON-LD, answered

  1. 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.

  2. Yes. Several blocks are fine, as long as they describe things consistently. Connecting them with @id keeps them from contradicting each other.

Keep reading

Let’s begin

Let’s build something you’re proud to share.

Let’s Talk