JSON-LD

06 March, 2025

JSON-LD is a simple, machine-readable format that optimizes your website for search engines. It is inserted into the HTML code and helps to better understand content and highlight it in search results.

The advantages at a glance:

SEO boost: Improved rankings and visibility through a clear data structure.
Rich Snippets: Additional information such as ratings and prices directly in the search results.
Easy implementation: JSON-LD is discussed separately in <script>The -tag is included and does not interfere with the HTML code.
Optimization for voice search: Perfect for voice search and local search results.

Example for JSON-LD:

Important: Use tools like this Google Rich Test Results:To validate your code and avoid errors, JSON-LD is a simple way to make your content more visible and attractive.

Add JSON-LD to your website

Implementing JSON-LD can give your website a clear SEO advantage. Here's how and where to implement the code.

Where should the JSON-LD code be placed?

There are two options for inserting the JSON-LD code:

Im <head>-section of your HTML file
Im <body>-section of your HTML file

A simple example could look like this:

JSON-LD code

Detailed JSON-LD example

Here is a more detailed JSON-LD code for a company, including contact information:

Typical setup errors

Several problems can occur when working with JSON-LD. Here are the most common errors and how to fix them:

Error	solution
Syntax error	Use a JSON validator to find errors.
Missing required fields	Check the Schema.org-Documentation checked for completeness.
Incorrect data types	Adhere to standards such as ISO 8601.
Invalid URLs	Always use absolute URLs.

When inserting complex information such as opening hours or product details, make sure the data is nested correctly.

Tip: You can use the Google Structured Data Testing Tool to test your JSON-LD code. It shows you errors and gives you suggestions on how to optimize your code.

Testing your JSON-LD code

It is important to regularly check JSON-LD with suitable tools to ensure that search engines can interpret the data correctly.

Google tools for verification

Google provides two main tools to test your JSON-LD code:

Rich Results TestThis tool is used to validate structured data and offers the following functions:

Verification of permissions for rich snippets
Real-time detection of errors and warnings
Simulation of the display in the search results

Schema markup validatorThis tool provides a detailed technical analysis. Here are some of its features:

Other specifications	Description
Syntax check	Detects faulty JSON structures
Schema validation	Checks for compliance with Schema.org
Fault diagnosis	Finds problem areas in the code
Live preview	Displays the data structure in real time

Besides the Google tools, there are other helpful options for checking JSON-LD.

Alternative testing options

Sitebulb is ideal for larger websites and offers the following advantages:

Analysis of large quantities of JSON-LD implementations
Detailed reports on structured data
Detection of inconsistencies across multiple pages

Classy scheme offers a user-friendly interface with:

Visual representation of the JSON-LD structure
Real-time code validation
Templates for different scheme types

When should tests be carried out?

After changes to the code
During updates to Schema.org
Quarterly as a routine check
Following major structural changes to the website

Using various tools ensures that both obvious and hidden errors are identified. Regular review helps guarantee the long-term quality and functionality of your JSON-LD code.

SEO and user results

Validating your JSON-LD code will quickly show you how structured data impacts the visibility and interaction of your content. JSON-LD enables better content indexing and improved display in search engines.

Rich Search Results

JSON-LD enables improved display in search results through rich snippets. Especially on mobile devices, click-through rates of up to... 31,35% This can be achieved. This representation offers clear advantages:

Form of presentation	Benefits	impact
Product Information	Price, availability and reviews visible	35% more page views
FAQ snippets	Display of frequently asked questions directly in the results	Higher click rates
Local business information	Opening hours and location in Maps	Improved local visibility
Rating stars	Customer reviews visually highlighted	More trust among users

Search engines are constantly evolving, which further increases the relevance of structured data.

Search engine updates

As search technologies continue to evolve, JSON-LD is becoming increasingly important.

Current developments:

Improved voice search and enhanced knowledge graph display.

Prepared for the future:

Support for semantic search and improved interpretation by crawlers.

The correct integration of JSON-LD not only offers a competitive advantage, but also makes your website fit for future developments in the field of search engine optimization.

JSON-LD Examples and Tips

Here you will learn how to refine your JSON-LD implementation, building on the fundamentals and testing phase from the previous sections. Advanced implementations require a good understanding of complex data structures and best practices.

Complex data structures

Nesting JSON-LD objects allows you to precisely represent detailed business information. One example is structuring the data of an online shop.

level	Elements	Benefits
Main level	Business information	Basic identification
second level	Product categories, locations	Improved navigation
Third level	Individual products, service information	Detailed product information

The nesting process progresses step-by-step from general to specific information. Here's an example of what a JSON-LD structure for an online shop might look like:

JSON-LD structure

Once the basics of complex structures are clear, let's take a look at important guidelines for optimal implementation.

Implementation guidelines

These tips will help you make your JSON-LD implementation efficient and future-proof.

Basic principles:

Take advantage of that @context-attribute with https://schema.org.
Ensure correct typing with @type Sich.
Keep property names and values consistent.

Practical tips:

Regular updatesKeep your schema markup up to date to keep pace with the latest standards.
ValidationCheck your JSON-LD after changes using tools like Google's Rich Results Test.
Scalable structuresPlan your data structure so that it can be easily expanded.

Careful implementation of these guidelines improves the display of your content in search results and increases your visibility. This makes your technical implementation more effective and optimally supports your SEO strategy.

Summary

JSON-LD improves both SEO performance and user experience. Building on the previous implementation tips, we summarize the key benefits and next steps here.

Advantages of JSON-LD

JSON-LD helps website operators use structured data clearly and efficiently. This improves search engine visibility and allows content to be displayed more effectively.

Area	Advantage	effects
search engines	Improved detection	Higher rankings in search results
presentation	rich results	More attractive snippets in search results
Data structure	Clear organization	Easier adaptation to future requirements

Next Steps

Select relevant schema types: Use schema.org to find the right types for your content.
Correctly insert JSON-LD: Ideally, place the code in <head> your website.
Conduct regular tests: Use the Google Rich Results Test to ensure everything is working correctly.
Monitor results: Analyze the impact on your search results and adjust as needed.
Schedule updates: Keep your structures up-to-date to keep pace with new standards.

Correct data nesting is particularly important. Using the schema.org vocabulary ensures your website remains compatible with search engines like Google, Bing, and Yahoo. These measures allow you to specifically improve your website's performance.

Frequently Asked Questions

Here you will find answers to important questions about the implementation and testing of JSON-LD.

Which tool is suitable for testing structured data?

The Google Rich Test Results: is ideal for checking JSON-LD.

Other specifications	Description
Preview	Shows how your rich results could look in Google search.
Validation	Checks if your JSON-LD has been implemented correctly.
Troubleshooting	Identifies and helps fix markup errors.
Compatibility	Test whether your markup is suitable for the supported rich result types.