---
title: "JSON-LD Explained for Local Business Websites"
description: "JSON-LD is the code format Google recommends for schema markup. See what it is, why it beats the alternatives, and where it goes in your web page."
source: "https://www.lighthouselocal.ai/glossary/json-ld"
---

[Home](https://www.lighthouselocal.ai/) / [Glossary](https://www.lighthouselocal.ai/glossary) / JSON-LD

# JSON-LD

[Structured data](https://www.lighthouselocal.ai/glossary#structured-data)

JSON-LD is a lightweight format for writing structured data as a block of code in a web page, and it's the format Google recommends for schema markup when your site allows it.

## Why it matters

When someone says "add schema markup to your site," JSON-LD is usually the format they mean. It keeps the labeled facts in one tidy block, separate from the text your visitors read, so you can add or fix it without touching the design. Most website platforms and SEO plugins write it for you.

## Example

A landscaper's website plugin adds one block to the page head. It holds her business name, address, phone number, and hours, each tagged with a Schema.org label. Visitors never see it. When she changes her phone number, she updates the plugin setting once and the block follows, rather than hunting through the page for scattered tags.

## What JSON-LD is

The W3C, the web's standards body, describes JSON-LD as a lightweight syntax to serialize Linked Data in JSON. Put simply, it's a way to write facts as labeled pairs, such as a name and its value, so a program can tell what each fact means. It's only a format. The labels themselves usually come from the Schema.org vocabulary, which is why you'll hear JSON-LD and [schema markup](https://www.lighthouselocal.ai/glossary/schema-markup) used together.

A JSON-LD block for a local business is a short run of those pairs. It names the vocabulary it uses, states the type of thing described, such as a [LocalBusiness](https://www.lighthouselocal.ai/glossary/localbusiness-schema), then lists properties like the name, telephone number, and address. The address is itself a nested group with its own street, city, and postal code.

## Why Google recommends it

Google's structured data documentation says its search supports three formats: JSON-LD, Microdata, and RDFa. It states that all three are equally fine for Google as long as the markup is valid and implemented properly, and it recommends the format that's easiest for you to implement and maintain, which in most cases is JSON-LD. It also says Google recommends JSON-LD if your site's setup allows it, because it's the easiest option for site owners to implement and maintain at scale, and less prone to user errors.

Google gives a reason that matters in practice. JSON-LD isn't interleaved with the visible text, which makes nested items easier to express. Microdata and RDFa, by contrast, add attributes directly to the page's HTML tags. Google can also read JSON-LD that's injected into the page by JavaScript or by an embedded widget from a content management system.

## Where it goes in a page

JSON-LD sits inside a script tag in the page's HTML, with the type set to application/ld+json. Google's documentation says it can be placed in the head or the body of the page. Nothing about it shows on screen, so it doesn't change how the page looks.

The markup should describe what's actually on the page. Run your finished page through Google's Rich Results Test before you ship it, as Google's documentation suggests for validation. If you use a plugin or a website builder, check what it already outputs before adding a second block that says the same thing.

## Sources

- [Google Search Central: Intro to How Structured Data Markup Works](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data)
- [W3C: JSON-LD 1.1](https://www.w3.org/TR/json-ld11/)

Related terms

- [Schema markup](https://www.lighthouselocal.ai/glossary/schema-markup)
- [LocalBusiness schema](https://www.lighthouselocal.ai/glossary/localbusiness-schema)
- [FAQPage schema](https://www.lighthouselocal.ai/glossary/faqpage-schema)
- [AggregateRating schema](https://www.lighthouselocal.ai/glossary/aggregaterating-schema)

More in Structured data

- [Entity](https://www.lighthouselocal.ai/glossary/entity)
- [Knowledge panel](https://www.lighthouselocal.ai/glossary/knowledge-panel)

## Ready to see how AI describes your business?

Set up in ten minutes with a 14-day free trial on every self-serve plan, or talk to a specialist first.

[Start Free Trial](https://app.lighthouselocal.ai/?utm_source=lighthouselocal&utm_medium=marketing-site&utm_campaign=glossary-json-ld&utm_content=closer) Book a Demo

## Sitemap

- [Markdown sitemap](https://www.lighthouselocal.ai/sitemap.md)
