What is JSON-LD?
Think of your web page as a parcel.
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.