Why does Google recommend JSON-LD?

Google recommends JSON-LD because it's easier to implement and maintain compared to other structured data formats. It can be added anywhere in the HTML document and doesn't need to be interleaved with user-visible content. Learn more: [Structured Data](/glossary/structured-data)

Can I use multiple JSON-LD scripts on one page?

Yes, you can implement multiple JSON-LD scripts on a single page to describe different content elements. Each script should focus on a specific entity or relationship.

How does JSON-LD impact SEO?

JSON-LD helps search engines better understand your content, potentially enabling rich results in search listings, which can improve click-through rates and visibility.

What is JSON-LD? - SEO Glossary

How JSON-LD Works

JSON-LD functions by embedding structured data directly into HTML documents using JavaScript notation. Unlike other structured data formats, JSON-LD can be placed anywhere within the HTML document's or sections, making it more flexible and easier to implement than microdata or RDFa.

The format uses a standardized vocabulary, typically from schema.org, to describe content elements and their relationships. Each JSON-LD script contains a context (@context) that defines the vocabulary being used, and a type (@type) that specifies what kind of entity is being described.

Why JSON-LD Matters

JSON-LD plays a crucial role in modern SEO by helping search engines understand website content more accurately. According to Google's official documentation, JSON-LD is their recommended format for structured data implementation due to its ease of deployment and maintenance.

When properly implemented, JSON-LD can enhance search results with rich snippets, knowledge graph entries, and other enhanced SERP features. This can lead to improved visibility and higher click-through rates from search results.

JSON-LD Implementation Patterns

The most common implementation pattern involves placing JSON-LD scripts in the document head. Each script block describes specific entities or relationships on the page, such as articles, products, organizations, or events. Multiple JSON-LD blocks can coexist on the same page, each describing different content elements.

JSON-LD in Practice

Implementing JSON-LD requires careful attention to syntax and schema validation. The structured data must accurately represent the visible page content and follow Google's structured data guidelines. Regular testing through Google's Rich Results Test tool helps ensure proper implementation and identifies potential issues that could prevent rich results from appearing.

Usage Examples

Article Markup Example

Standard article markup using JSON-LD, showing how to structure content for blog posts or news articles. This implementation enables article-specific rich results in Google Search.

{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Complete Guide to Technical SEO",
"author": {
  "@type": "Person",
  "name": "John Smith"
},
"publisher": {
  "@type": "Organization",
  "name": "Moz",
  "logo": {
    "@type": "ImageObject",
    "url": "https://moz.com/logo.png"
  }
},
"datePublished": "2024-01-15",
"dateModified": "2024-01-20",
"description": "Learn everything you need to know about technical SEO implementation."
}

Product Schema Implementation

Product schema implementation for e-commerce, enabling rich product results with pricing, availability, and ratings in search results.

{
"@context": "https://schema.org",
"@type": "Product",
"name": "SEMrush Pro Plan",
"description": "Professional SEO toolkit for digital marketers",
"brand": {
  "@type": "Brand",
  "name": "SEMrush"
},
"offers": {
  "@type": "Offer",
  "price": "119.95",
  "priceCurrency": "USD",
  "availability": "https://schema.org/InStock"
},
"aggregateRating": {
  "@type": "AggregateRating",
  "ratingValue": "4.8",
  "reviewCount": "2149"
}
}

What is JSON-LD?