Glossary

What is JSON-LD?

JSON-LD is a way of adding structured data to a web page as a block of JSON in a script tag, describing what the page is about with schema.org types such as Organization, Article or VideoObject.

A visitor reads the page. A search engine can read the page too, but JSON-LD tells it the same facts in a fixed shape: this is a video, this is its title, this is its upload date, this is who published it. Because the block sits apart from the visible HTML, it can be added without touching the layout.

Nodes can point at each other with an @id. One Organization node, defined once, can be the publisher of every article and the creator of every case study on the site. That linking is what turns a pile of separate markup blocks into one consistent description of an entity.

The rule that matters most is that the markup must match the page. FAQ markup repeats questions the page prints. A VideoObject describes a video the page actually shows. Markup that claims more than the page does can be ignored, and it teaches systems to trust the rest of the site less. Each type also has fields a search engine requires before it uses the markup, so check them against the documentation.

An example from our own work

Videojam, our own video platform, ships VideoObject JSON-LD checked against Google’s required fields, plus FAQPage, ItemList, CollectionPage and BreadcrumbList. On audacian.eu every prerendered page carries a JSON-LD graph in its HTML: one Organization node with a stable @id, a Person for the founder linked to it, WebPage and BreadcrumbList on each page, Service on service pages, CreativeWork for case studies, SoftwareApplication for products, Article for insights, FAQPage where the questions are printed, and VideoObject for the videos on our video page, each with the organization as publisher. The graph is generated from the same config and content files as the visible text.

Tell us what you're launching.

Book a 20-minute intro call, or email a few lines about what you're launching. We'll reply with a rough plan and a price range, whether or not we end up working together.