What is JSON-LD?

Think of your web page as a parcel.

A parcel with a shipping label, and a robot reading the labelOn the left is a parcel. This is the web page that people open and read. A shipping label is stuck on the parcel and lists what it is, the name and the opening hours. On the right a robot points a scanner at the label.LABELtype: Cafename: Harbour Cafeopen: Mon to Fri, 7 to 3The pagePeople open it and read itGoogle's robotIt reads the label firstA parcel with a shipping label, and a robot reading the labelAt the top is a parcel. This is the web page that people open and read. A shipping label is stuck on the parcel and lists what it is, the name and the opening hours. Below it a robot points a scanner at the label.LABELtype: Cafename: Harbour Cafeopen: Mon to Fri, 7 to 3The pagePeople open it and read itGoogle's robotIt reads the label first
A person opens the parcel. A robot reads the label on the outside. JSON-LD is the label.

The parcel and the label

Inside the parcel is your page: the pictures, the words, the prices. People open it and read it.

On the outside there can be a shipping label. A sorting robot is not good at opening the parcel and working out what is in it. It reads the label: what is this, who sent it, what is it called, when is it open.

That label is JSON-LD. It is a few lines of tidy text, hidden in your page, written in words that robots agree on (a shared list called schema.org). Visitors never see it.

Google says it uses labels like this to understand a page, and sometimes to show extra details in results, such as opening hours or a price. Google's own introduction explains it.

What can go wrong with a label

  • No label. The parcel still arrives. Google reads your page as usual. A label is a help, not a rule.
  • A smudged label. One missing comma and the robot cannot read it, so it ignores it. Your page is fine, but the label did nothing.
  • Two labels that disagree. Two plugins can each stick on their own. If they say different things, it is harder to know which is right.
  • A label for something that no longer exists. Google stopped showing FAQ results in May 2026. A label for them is harmless, it just does nothing now.
  • A label that tells fibs. Google's rules say the label has to match what visitors can see on the page.

Who writes the label?

Usually your website tool does it for you. WordPress plugins, Shopify, Squarespace and Wix all add labels without you doing anything. So the real question is rarely "how do I write one?" It is "is the one I already have fine?"

That is what the checker answers.