SEO & AEO

JSON-LD

The format Google recommends for adding schema markup, written as a script block separate from visible content.

By Nick Irmo · Updated

What JSON-LD means

JSON-LD keeps structured data tidy and easy to maintain because it does not tangle with your page HTML. Most CMS SEO tools generate it, and custom builds can produce it from your content model. Test it with Google's Rich Results Test after changes.

Why it matters for your website

Search engines and AI tools read JSON-LD to understand facts like your business hours, prices and reviews without guessing from page text. Because it sits in its own script block, you can add or fix it without touching your design, which makes it cheaper to maintain. Clean markup also makes your pages eligible for rich results that can stand out in search.

Example

A dental office adds a JSON-LD block to its homepage listing its name, address, phone, hours and accepted insurance. Google can now read those details directly instead of piecing them together from the footer.

Tips

  • Test every JSON-LD block with Google's Rich Results Test before and after you publish.
  • Make sure each fact in your markup also appears in the visible content of the page.
  • Use one consistent business name, address and phone across your markup and your Google Business Profile.

Common mistakes

  • Marking up reviews, prices or FAQs that visitors cannot actually see on the page.
  • Copying a template and forgetting to replace placeholder values like sample addresses or phone numbers.

Questions about JSON-LD

What is JSON-LD?
The format Google recommends for adding schema markup, written as a script block separate from visible content.
Is JSON-LD better than microdata?
Google supports JSON-LD, microdata and RDFa, but it recommends JSON-LD because it is easier to add and maintain. It also keeps your structured data separate from your HTML layout.
Where should I put JSON-LD on a page?
You can place the script block in the head or the body of the page. Google reads it in either spot, including when it is added by JavaScript, as long as the page renders properly.

Learn more

Tell us what the site needs to do.

Share a few details and a budget range. We reply within one business day with a plan, a platform recommendation and a fixed quote.