TeckBlaze
← All articlesHome

← All articles

Technical SEO
Schema
Structured Data

JSON-LD Schema: structured data guide

March 7, 2026 · 9 min read

JSON-LD structured data is the number one signal for getting rich snippets in Google and improving the precision of answers generated by AI models. This guide explains what JSON-LD is, the main schema types, how to implement them, and how to test them to maximize your visibility in SERPs and generative search engines.

What is JSON-LD?

JSON-LD (JavaScript Object Notation for Linked Data) is a structured data format recommended by Google for communicating semantic information about a web page's content. Unlike microdata or RDFa that integrate into HTML, JSON-LD is placed in an independent <script type="application/ld+json"> block, typically in the page's <head>.

The main advantage of JSON-LD is its simplicity of implementation: it is not tied to the page's HTML structure and can be added or modified without touching existing markup. Google explicitly recommends JSON-LD as the preferred format for structured data. It is the easiest format to generate dynamically via a CMS or JavaScript framework.

Structured data follows the vocabulary defined by Schema.org, a collaborative project founded by Google, Microsoft, Yahoo, and Yandex. Schema.org defines hundreds of object types (@type) and properties to describe businesses, articles, products, events, FAQs, recipes, and much more.

TeckBlaze automatically detects the presence and quality of JSON-LD structured data on every audited page. Our engine checks for JSON-LD blocks, the presence of the required @type, and property completeness for each detected type. The absence of structured data receives medium severity in the audit report.

Essential schema types

Organization: The Organization schema describes your business. It should appear on your homepage and include the name, logo, URL, social media links (sameAs), and contact information. It is the foundational schema that helps Google understand who is behind the site. TeckBlaze flags the absence of Organization or WebSite on the homepage as a medium severity issue.

LocalBusiness: For local businesses, the LocalBusiness schema extends Organization with geographic information: address, phone, opening hours, service area. TeckBlaze detects over 20 subtypes (Restaurant, Store, Hotel, Dentist, Plumber, etc.) and checks for NAP (Name, Address, Phone) properties.

Article and BlogPosting: For blog posts and content pages, these schemas indicate the title, author, publication date, modification date, and description. They are essential for appearing in Google News and Google Discover, and for AI models to correctly cite the source.

FAQPage: The FAQPage schema describes question-answer pairs. It enables a FAQ rich snippet directly in Google results, displaying questions with clickable accordions. It is one of the most impactful schemas for SERP visibility.

BreadcrumbList: This schema describes the page's breadcrumb trail and helps Google display a navigation structure in search results. It also improves search engine and AI model understanding of your site hierarchy.

Product: For e-commerce sites, the Product schema enables displaying price, availability, reviews, and ratings in Google results. It is a powerful CTR lever for product pages.

How to implement JSON-LD

The basic implementation consists of adding a <script type="application/ld+json"> block in the <head> or <body> of each page. Here is an example for a homepage with Organization schema: {"@context": "https://schema.org", "@type": "Organization", "name": "TeckBlaze", "url": "https://teckblaze.com", "logo": "https://teckblaze.com/logo.png", "sameAs": ["https://twitter.com/teckblaze"]}.

For a blog post, combine Article and FAQPage in a @graph: {"@context": "https://schema.org", "@graph": [{"@type": "Article", "headline": "Title", "datePublished": "2026-03-07", "author": {"@type": "Organization", "name": "TeckBlaze"}}, {"@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "Question?", "acceptedAnswer": {"@type": "Answer", "text": "Answer."}}]}]}.

In a React/Next.js framework, JSON-LD can be dynamically generated via a component: place a <script type="application/ld+json" dangerouslySetInnerHTML={{__html: JSON.stringify(jsonLd)}} /> element in your page component. Data can be built from page props or a CMS.

For WordPress sites, plugins like Yoast SEO, Rank Math, or Schema Pro automatically generate structured data. Always verify the output with a testing tool to ensure the schema is complete and valid.

JSON-LD and AI engines (GEO)

JSON-LD plays a crucial role in Generative Engine Optimization (GEO). AI models like ChatGPT, Claude, and Perplexity use structured data to understand a page's context with more precision than raw text.

JSON-LD properties provide LLMs with structured, unambiguous information: the exact business name, field of activity, contact details, article authors, publication dates. This information allows AI models to cite your site accurately and include correct attributions.

TeckBlaze measures structured data completeness as part of each page's GEO score. JSON-LD represents 30% of the page-level GEO score. The most important types for GEO are Organization, Article, FAQPage, and LocalBusiness. A site with complete structured data is significantly more likely to be cited by AI models.

Testing and validation tools

Google offers two official tools for testing your structured data. The Rich Results Test (search.google.com/test/rich-results) checks if your page is eligible for rich snippets and shows a preview of the enriched result. The Schema Markup Validator (validator.schema.org) validates JSON-LD syntax against the complete Schema.org vocabulary.

TeckBlaze integrates structured data detection and analysis into every audit. Our engine extracts all JSON-LD blocks, identifies present types (@type), checks for required properties, and calculates a completeness score. The report identifies recommended missing schemas for each page type.

For development, Google's Schema Builder Chrome extension allows visually building JSON-LD blocks. The JSON-LD Playground extension allows real-time syntax testing and validation. These tools are essential for ensuring your structured data is correct before going to production.

Common mistakes

The most common mistake is the complete absence of structured data. Many sites don't leverage JSON-LD, depriving Google and AI models of structured information about their content. TeckBlaze classifies this absence as medium severity because it's a missed opportunity rather than a technical problem.

A JSON-LD block without @type is unusable. Without the object type, search engines don't know how to interpret the data. Ensure every JSON-LD block contains at minimum a @context and a valid @type.

Incomplete properties reduce schema effectiveness. An Organization without a logo, an Article without datePublished, or a LocalBusiness without an address limit possible rich snippets. Aim for maximum completeness for each schema type used.

Beware of incorrect or misleading data: Google may apply a manual action if your structured data doesn't match the actual page content. Prices, reviews, and availability must be accurate and up to date.

FAQ

JSON-LD (JavaScript Object Notation for Linked Data) is a structured data format that communicates semantic information about a web page's content to search engines and AI models. It appears as a <script type="application/ld+json"> block placed in the page's HTML code. JSON-LD uses the Schema.org vocabulary to describe entities like organizations, articles, products, FAQs, etc. It is the structured data format recommended by Google.

JSON-LD is not a direct ranking factor, but it significantly improves your page visibility in several ways. First, it enables rich snippets in Google: review stars, clickable FAQs, product prices, breadcrumbs. These enriched results considerably increase click-through rate (CTR). Second, JSON-LD improves Google's understanding of your content, which can help ranking for specific queries. Third, for GEO (Generative Engine Optimization), JSON-LD is the number one signal for AI models like ChatGPT to correctly cite your site.

The most important schemas depend on the site type. For all sites: Organization (homepage) and BreadcrumbList (all pages). For blogs: Article or BlogPosting and FAQPage. For local businesses: LocalBusiness with complete NAP. For e-commerce: Product with price and availability. TeckBlaze automatically detects present types and recommends missing ones based on the detected page type.

Related articles:

SEO TechniqueGEO / IAGEO & IA
Check your structured data with TeckBlaze