Technology

How to Add JSON-LD Structured Data to a Website for Better Search Results

Daniel Carter

Daniel Carter

— 4 min read
Share
A computer screen showing a JSON-LD code snippet inside an HTML script tag for structured data.

JSON-LD structured data is a simple way to provide search engines with detailed information about your website content. By adding JSON-LD, you help search engines better understand your pages, which can improve your site's SEO and enable rich results like star ratings, event dates, or product details in search listings. To add JSON-LD correctly, you need to create valid code tailored to your content, insert it properly into your HTML, and test it for errors to ensure it works as expected.

What is JSON-LD and why should I add it to my website?

JSON-LD stands for JavaScript Object Notation for Linked Data. It's a format that describes your website's content in a structured way, making it easy for search engines to understand. Unlike older methods that mix structured data directly into HTML tags, JSON-LD uses a separate script block, which keeps your page cleaner and easier to update. Adding JSON-LD can boost your SEO by enabling rich results—enhanced search listings that show extra details such as star ratings, prices, or event dates. These rich snippets can increase your click-through rates by making your listing more attractive and informative.

How do I create the right JSON-LD code for my site?

To create JSON-LD code, first identify the type of content on your page. Use Schema.org's vocabulary to find the right type, such as Article, Product, Event, or Recipe. Then select the relevant properties for that type—for example, an article might include headline, author, datePublished, and image, while a product might include name, price, brand, and availability. Write your JSON-LD markup as a JavaScript object, following strict JSON syntax: use double quotes for keys and values, separate entries with commas, and avoid trailing commas. Make sure your data matches the visible content on your page accurately and keep it up to date.

Where should I place JSON-LD code in my website’s HTML?

Insert your JSON-LD code inside a <script> tag with the attribute type="application/ld+json". This tag can be placed either in the <head> section or just before the closing </body> tag of your HTML document. Placing it in the <head> is common because it loads early, but both locations work. The script tag should contain only the JSON-LD code—no other scripts or HTML. For example:

<head>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "How to Add JSON-LD Structured Data to a Website",
    "author": "Jane Doe"
  }
  </script>
</head>

Make sure your JSON-LD data accurately reflects the page’s visible content to avoid confusing search engines.

A computer screen showing JSON-LD code snippet inserted inside the head section of an HTML document.

How can I test my JSON-LD structured data to ensure it works?

Before publishing, test your JSON-LD using tools like Google's Rich Results Test and the Schema Markup Validator. These tools check your code for syntax errors, missing required fields, and unsupported schema types. To test, either paste your JSON-LD code or enter your page’s URL. The tools will highlight any problems and show a preview of how rich results might appear. Fix any errors and retest until your markup passes without issues. Testing ensures search engines can read your structured data and use it to enhance your search listings.

What common mistakes should I avoid when adding JSON-LD?

Avoid these common errors to ensure your JSON-LD works correctly:

  • Syntax errors: Missing commas, quotes, or braces can break your JSON. Use a JSON validator to check your code.
  • Incorrect schema types: Choose schema types that match your content to prevent confusion.
  • Content mismatch: The structured data must match what users see on the page.
  • Incorrect placement: JSON-LD must be inside a <script type="application/ld+json"> tag; placing it as plain text or in other script types won’t work.
  • Including irrelevant data: Only include information that pertains directly to the page’s content.

By avoiding these mistakes, you help search engines understand your site better and reduce the chance your markup will be ignored.

Conclusion

Once you create valid JSON-LD structured data, insert it properly, and test it without errors, your website will provide clearer information to search engines. This can lead to richer search result appearances and potentially higher click-through rates. Keep your structured data updated as your content changes, and retest periodically to maintain accuracy. Adding JSON-LD is a straightforward step that can improve how your site performs in search results.

Frequently Asked Questions

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

Yes, you can add multiple JSON-LD script blocks on the same page to describe different content types, such as an article and an event. Just ensure each block contains valid JSON and corresponds accurately to the content it describes.

Do I need to know JavaScript to use JSON-LD?

No, JSON-LD is written in JSON format, which is plain text. You don’t need to write JavaScript code—just include the JSON inside a script tag as shown in the examples.

Will adding JSON-LD guarantee rich snippets in search results?

Adding JSON-LD improves your chances by making your content clearer to search engines, but it doesn’t guarantee rich snippets. Google decides if and when to show rich results based on many factors beyond structured data.

Read more