guide

How to Add JSON-LD Schema Markup (2026)

By Rui Barreira · Last updated: 18 June 2026

JSON-LD schema markup is a snippet of structured data you add to a page so search engines understand what your content is — a product, a recipe, an article, a local business. Google reads it to generate rich results: star ratings, FAQs, breadcrumbs, and event dates directly in the SERP. The JSON-LD Schema Builder generates valid markup in seconds without writing a line of code.

What JSON-LD Schema Markup Does

Search engines can infer a lot from HTML, but structured data removes ambiguity. A <h1> heading might be a product name, a blog title, or a person's name — schema tells Google exactly which one. JSON-LD (JavaScript Object Notation for Linked Data) is Google's preferred format because it lives in a <script> tag and does not require touching your HTML structure.

Schema TypeRich Result UnlockedCommon Use
ProductPrice, availability, star ratingE-commerce product pages
FAQPageExpandable Q&A under the listingSupport pages, landing pages
ArticleHeadline, author, date in news carouselBlog posts, news articles
LocalBusinessAddress, hours, phone in Knowledge PanelRestaurants, services, stores
EventDate, location, ticket linkConcerts, webinars, conferences
BreadcrumbListSite path shown under the URLAny multi-level site

How to Add JSON-LD to a Page

Place the generated snippet inside a <script type="application/ld+json"> tag in the <head> of your page, or anywhere in the <body> — Google parses both locations. One page can contain multiple JSON-LD blocks if it represents more than one entity (for example, a product page that also has an FAQ section).

For static sites, paste the block directly into the HTML template. For CMS-based sites like WordPress, use a plugin field or a theme header injection hook. For Next.js or React, render it as a dangerouslySetInnerHTML script tag in your page component or layout.

Common Mistakes to Avoid

Missing required fields are the most frequent cause of markup not qualifying for rich results. Google's requirements differ by type — a Product schema needs at minimum a name and either offers or aggregateRating; a FAQPage needs at least one Question with an acceptedAnswer. Copying a template and leaving placeholder values intact also disqualifies the markup. After adding schema, validate with Google's Rich Results Test to confirm eligibility before waiting for the next crawl.

Use the JSON-LD Schema Builder to do this instantly.

Frequently Asked Questions

Is this tool free?
Yes — completely free, no signup required. All processing happens in your browser.
Does the tool work offline?
Once loaded, most features work without an internet connection since everything runs client-side.
More free toolsSee all 469
Merge PDFsCompress ImageJSON FormatterPassword GeneratorVAT CalculatorQR Code Generator
How to Add JSON-LD Schema Markup (2026) | brevio