JSON-LD for SEO: Complete Schema Markup Guide (2026)

JSON-LD is Google's recommended structured-data format when a site's setup allows it. This guide covers implementation, validation, rich-result eligibility, and the evidence boundary for AI search.

What Is JSON-LD?

JSON-LD (JSON for Linking Data) is a method of encoding structured data using JSON syntax. It's embedded in your HTML within a <script type="application/ld+json"> tag and gives search systems explicit clues about the page's type, properties, and relationships.

Unlike Microdata or RDFa (which mix structured data into HTML attributes), JSON-LD is a standalone block that doesn't touch your visible HTML. This makes it easier to implement, maintain, and debug.

Why JSON-LD Matters for SEO in 2026

Rich Snippets in Google

Valid markup can make a page eligible for supported rich-result formats such as product, recipe, event, article, and video features. Google does not guarantee that an eligible feature will appear. Its published case studies report different outcomes by site, including an 82% click-through-rate increase for Nestlé pages that actually appeared as rich results. That case study is not a universal schema benchmark.

Google AI features

Google's current AI-features guidance says there is no special schema.org markup required for AI Overviews or AI Mode. Pages must satisfy normal Search eligibility, and any structured data should match the visible text. Google does not promise that adding JSON-LD will create an AI Overview citation.

Knowledge Graph

Organization, Person, and Product markup gives Google explicit entity information. Whether Google uses that information in a knowledge panel or another Search feature remains a system-level decision.

Essential Schema Types

Here are the most impactful schema types for SEO, with examples:

1. Article / BlogPosting

For blog posts and articles. Enables article rich results with author, date, and image.

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Your Article Title",
  "author": {
    "@type": "Person",
    "name": "Author Name"
  },
  "datePublished": "2026-03-15",
  "image": "https://example.com/image.jpg",
  "publisher": {
    "@type": "Organization",
    "name": "Your Site"
  }
}

2. FAQPage

FAQPage remains a schema.org type for publisher-authored question-and-answer sections, but Google stopped showing FAQ rich results on May 7, 2026. Do not add it expecting a visible Google Search feature or an AI citation lift.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "What is GEO?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "GEO (Generative Engine Optimization) is..."
    }
  }]
}

3. Product

For product pages. Enables price, availability, and rating rich snippets.

4. LocalBusiness

For local businesses. It describes details such as business type, address, hours, and contact information. Keep the markup consistent with the page and Business Profile.

5. WebApplication / SoftwareApplication

For web apps and SaaS products. Tells search engines about your app's features, pricing, and platform support.

Use our JSON-LD Schema Generator to create markup for all 9 supported schema types. No coding is required.

How to Add JSON-LD to Your Site

Generate the markup. Use our Schema Generator or write it manually following schema.org specifications.
Add it to your HTML. Place the <script type="application/ld+json"> tag in your page's <head> or <body>.
Validate. Use our Structured Data Tester or Google's Rich Results Test to check for errors.
Monitor. Check Google Search Console's Enhancements tab for schema issues and rich result eligibility.

JSON-LD Best Practices

Use the most specific schema type (e.g., NewsArticle instead of Article for news)
Include the required properties for the specific Google Search feature.
Keep data accurate. Misleading markup can lose rich-result eligibility.
Use multiple schema types per page (e.g., Article + FAQPage + BreadcrumbList)
Don't mark up content that isn't visible on the page
Add schema to every page, not just the homepage

JSON-LD for AI Search (GEO)

AI search engines use structured data to understand your content, but the relationship between schema and AI citations is more nuanced than vendor blogs claim. Here's what the evidence actually shows:

Evidence check: A December 2024 study found no statistically meaningful correlation between schema markup coverage and LLM citation frequency. Google's current public guidance says there is no special schema.org markup required for AI Overviews or AI Mode. OpenAI, Perplexity, and Anthropic do not publish an equivalent schema-to-citation contract. Treat JSON-LD as explicit page classification, not a citation guarantee.

With that context, here are the highest-leverage schema strategies for AI visibility:

Match visible content. Google explicitly requires structured data to represent the page users can read.
Choose the page's primary type. Article, Product, LocalBusiness, Organization, and SoftwareApplication describe different entities and qualify for different supported features.
Keep claims bounded. The KDD 2024 GEO paper tested citation, quotation, fluency, statistics, and related text interventions. It did not test JSON-LD or establish a schema-to-citation lift.
Keep dates accurate. Use dateModified only when the page has materially changed.

Implementation boundary: Google says it can read dynamically injected JSON-LD. Other AI-search providers do not publish a uniform JavaScript-rendering contract. Server-rendered or inline JSON-LD offers the broadest inspectability, but it still does not guarantee indexing or citation.

Frequently Asked Questions

What is JSON-LD and why does Google recommend it?

JSON-LD (JSON for Linking Data) is a method of encoding structured data using JSON syntax, embedded in a <script> tag in your HTML. Google explicitly recommends JSON-LD as the preferred structured data format because it is generally easier for site owners to implement and maintain at scale.

Does JSON-LD improve AI search citations?

No citation lift is guaranteed. Google says there is no special schema.org markup required for AI Overviews or AI Mode. Structured data should match visible page content, while normal Search eligibility and Google's systems determine whether a supporting link appears.

Which JSON-LD schema types are most important for SEO?

Choose the type that matches the page and a Google-supported Search feature. Common types include Article, Product, LocalBusiness, Organization, BreadcrumbList, VideoObject, and SoftwareApplication. Google stopped showing FAQ rich results on May 7, 2026.

Does structured data directly improve Google rankings?

No. Google states that a structured-data manual action removes rich-result eligibility but does not affect ranking in web search. Valid markup creates eligibility for supported features and does not guarantee display.

Sources & Further Reading

Google Search Central: Introduction to structured data. JSON-LD format, supported-feature eligibility, implementation guidance, and site-specific case studies.
Google Search Central: General structured data guidelines. Visible-content parity, quality rules, ranking boundary, and no display guarantee.
Google Search Central: AI features and your website. Normal Search eligibility, visible-text parity, and no special AI schema requirement.
Google Search documentation updates. Records the May 7, 2026 FAQ rich-result deprecation.
Aggarwal, Murahari, Rajpurohit, Kalyan, Narasimhan & Deshpande, “GEO: Generative Engine Optimization,” KDD 2024. The tested interventions were textual; the study did not test JSON-LD.

Generate JSON-LD markup for free

Our schema generator supports 9 types. Create, copy, and paste into your site.

Open Schema Generator

Fundamentals: Learn about GEO (Generative Engine Optimization) and AEO (Answer Engine Optimization) (the two frameworks for optimizing your content for AI search engines).