What Is JSON-LD Structured Data
JSON-LD (JavaScript Object Notation for Linked Data) is the format Google recommends for adding structured data to web pages. It lives in a <script type="application/ld+json"> block in your HTML, completely separate from the visible content. Unlike Microdata or RDFa, which weave attributes into your existing markup, JSON-LD is a self-contained JSON object that you can add, modify, or remove without touching your page layout.
The vocabulary comes from Schema.org, a collaborative standard maintained by Google, Microsoft, Yahoo, and Yandex. When Google's crawler finds valid JSON-LD on your page, it can generate rich results - enhanced search listings with star ratings, FAQ accordions, recipe cards, event details, and more. These rich results take up more visual space and dramatically improve click-through rates.
Why JSON-LD Over Microdata or RDFa
| Format | Syntax | Maintenance | Google Preference |
|---|---|---|---|
| JSON-LD | JSON in a script block | Easy - decoupled from HTML | Recommended |
| Microdata | HTML attributes inline | Hard - tightly coupled to markup | Supported |
| RDFa | HTML attributes inline | Hard - tightly coupled to markup | Supported |
Schema.org Types That Trigger Rich Results
Not all Schema.org types produce visible changes in search results. Here are the types with the highest impact:
| Type | Rich Result | Impact on CTR |
|---|---|---|
Article | Enhanced listing with author, date | Medium |
FAQPage | Expandable Q&A accordion | High |
HowTo | Numbered steps inline | High |
Product | Price, rating, availability | Very High |
BreadcrumbList | Structured URL path | Medium |
LocalBusiness | Google Maps, business info | Very High |
Event | Date, venue, tickets in search | High |
WebSite | Sitelinks search box | Medium |
Recipe | Recipe card with image, time, rating | Very High |
VideoObject | Video carousel, key moments | High |
JobPosting | Jobs in Google for Jobs | Very High |
SoftwareApplication | App rating, price in search | High |
Organization | Logo, contact info in knowledge panel | Medium |
How to Use the Generated Code
- Select the schema type that matches your page content.
- Fill in the properties - required fields are marked.
- Copy the generated JSON-LD output.
- Paste it into a
<script type="application/ld+json">block in your page's<head>. - Validate using Google's Rich Results Test to confirm eligibility.
You can have multiple JSON-LD blocks on a single page. A typical setup includes BreadcrumbList for navigation plus Article or Product for the main content.
Common Mistakes
- Case-sensitive types -
"@type": "article"is invalid. It must be"Article"with a capital A. Schema.org types are case-sensitive. - Missing required properties - each type has required fields. An
Articlewithoutheadlineorimagewill fail validation. - Invalid date formats - dates must be ISO 8601:
2026-04-06T10:00:00+00:00, notApril 6, 2026. - Relative URLs - image and URL properties must be absolute, starting with
https://.
Structured Data and Open Graph
JSON-LD and Open Graph tags serve different systems. Open Graph controls how your links appear when shared on social media. JSON-LD controls how your pages appear in Google search results. You need both: generate your Open Graph tags for social sharing, and your JSON-LD here for search rich results. Use the Meta Tag Analyser to verify that your OG tags are in place alongside your structured data.