JSON-LD Generator
Generate Schema.org structured data from simple form inputs. Six schema types supported: WebSite, Organization, Article, BreadcrumbList, FAQPage, Product.
What is JSON-LD?
JSON-LD (JSON for Linking Data) is a structured data format that uses the Schema.org vocabulary to describe the meaning of your web pages to search engines. It's the format Google, Bing, and others officially recommend - you just drop a <script type="application/ld+json"> block into your HTML.
Valid structured data lets your search listings expand beyond the plain blue link into star ratings, prices, FAQ accordions, breadcrumbs, and thumbnails, which commonly lifts CTR 1.5× to 3× for eligible pages.
The six schemas supported here
- WebSite - site-wide metadata. Drop it on your homepage once; it's the basis for the Sitelinks Search Box.
- Organization - company or group info. Include a logo and social profile URLs in
sameAsto improve Knowledge Graph associations. - Article / BlogPosting - news or blog articles.
author,datePublished, and a coverimageare the key rich-result fields. - BreadcrumbList - hierarchy trail. Search results will display Home › Category › Current page instead of the raw URL.
- FAQPage - FAQ content. Google can render a full accordion under your listing, giving you disproportionate SERP real estate.
- Product - commercial products. Required for price, availability, and aggregate-rating rich results.
How to validate
Always validate generated JSON-LD with the official tools before shipping:
- Google Rich Results Test - checks if your page is eligible for rich results
- Schema Markup Validator - validates Schema.org syntax and vocabulary
Required and recommended fields by type
All "required" fields must be present for a page to be eligible for rich results. Based on Google's official documentation.
- Article - Required:
headline,image,datePublished. Recommended:author,dateModified,publisher.logo. Images should be at least 1200px wide. - FAQPage - Each Question needs
nameandacceptedAnswer.text. The same questions and answers must be visible in the page HTML - putting content only in JSON-LD violates Google's spam policies. - BreadcrumbList - Each ListItem needs
position,name, anditem(URL). The final item may omititem. - Product - Required:
name,image,offers.price,offers.priceCurrency. AddaggregateRatingorreviewto enable star ratings in search results. - Recipe - Required:
name,image,recipeIngredient,recipeInstructions. Adding cook time, nutrition info, and ratings produces richer results. - Event - Required:
name,startDate,location. For online events useeventAttendanceMode: OnlineEventAttendanceModeandlocation: VirtualLocation. - LocalBusiness - Key fields:
address,telephone,openingHoursSpecification. Keep this consistent with your Google Business Profile - they are separate systems.
Common errors and fixes
- "The value provided for X is invalid" - Dates must follow ISO 8601:
2026-04-20or2026-04-20T15:30:00+00:00. Human-readable date strings will be rejected. - FAQPage content mismatch with HTML - Since 2023 Google has limited FAQPage rich results to certain sites, and JSON-LD questions that do not appear in the page body are treated as spam.
- Missing itemReviewed - Review-related schemas (
Review,AggregateRating) require an explicititemReviewedproperty (Book, Product, Service, etc.). - Relative image URLs - Paths like
/image.jpgmay not resolve correctly for Google's crawler. Always use absolute URLs:https://example.com/image.jpg. - Multiple JSON-LD blocks are fine - One page can include separate
<script type="application/ld+json">blocks forArticle,BreadcrumbList, andFAQPagesimultaneously.
Official references
- Google Search Structured Data Gallery - Full list of supported rich result types and field requirements.
- Schema.org - The official JSON-LD vocabulary standard.
- Google Structured Data Guidelines - Spam policies and quality requirements.
- JSON-LD official documentation - JSON-LD 1.1 specification.
- Google Search Console - The "Enhancements" report shows structured data errors across your entire site.
For a complete SEO foundation, pair structured data with a Robots.txt Generator for crawler control, a Favicon Generator for brand identity, and the Schema.org Types Reference for the full type catalogue.
Frequently asked questions
Where exactly should JSON-LD go in my HTML?
Inside <head> is most common, but anywhere in <body> works too. Google parses the final rendered HTML, so JSON-LD injected by JavaScript is detected as well.
Can I use multiple schemas on one page?
Yes. A product detail page commonly has Product + BreadcrumbList + FAQPage at once. Put each in its own <script type="application/ld+json"> block, or combine them in a single block using the @graph array.
Will rich results appear immediately after adding structured data?
No. Google treats structured data as a signal, not a guarantee. Actual display depends on page quality, authority, competition, and other factors. Structured data only qualifies you as a candidate for rich results.
Will invalid JSON-LD hurt my SEO?
Syntax errors are simply ignored, so there's no direct penalty. However, using fake reviews or irrelevant structured data to mislead users violates Google's spam policies and can trigger manual actions.