JSON-LD Schema Markup: Complete Guide 2026
Have you ever seen a Google search result with star ratings, FAQ dropdowns, or recipe cards? That's schema markup at work. Adding structured data to your site can dramatically improve your visibility and click-through rate.
In this complete guide, you'll learn what JSON-LD schema is, how to add it, and which types matter most for SEO.
What is Schema Markup?
Schema markup (also called structured data) is a standardized vocabulary created by Schema.org that helps search engines understand your content. It tells Google: "This is a recipe," "This is a product review," or "This is an FAQ."
With schema, Google can display rich snippets โ enhanced search results with extra information like ratings, prices, or images.
What is JSON-LD?
JSON-LD (JavaScript Object Notation for Linked Data) is the recommended format by Google for adding schema markup. Unlike Microdata or RDFa, JSON-LD doesn't require changing your HTML โ you just add a script block.
Google, Bing, and other search engines all support JSON-LD.
Basic JSON-LD Example
Here's a simple Article schema in JSON-LD:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "What is SEO? Complete Beginner's Guide",
"author": {
"@type": "Person",
"name": "John Doe"
},
"datePublished": "2026-01-15",
"image": "https://smp-web.com/images/seo-guide.jpg"
}
</script>
Just paste this in your page's <head> or <body>, and Google will understand your content better.
Why Schema Markup Matters for SEO
- Rich snippets โ Stand out in search results
- Higher CTR โ Rich results get up to 30% more clicks
- Better understanding โ Google knows exactly what your page is about
- Voice search โ Structured data helps with voice assistants
- Featured snippets โ Increases chances of appearing in position zero
- Not a ranking factor directly โ but CTR improvements help rankings over time
Most Important Schema Types
1. Article / BlogPosting
For blog posts and news articles. Enables rich results with author info and publish date.
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "Your Post Title",
"image": "https://smp-web.com/image.jpg",
"author": {
"@type": "Person",
"name": "Your Name"
},
"publisher": {
"@type": "Organization",
"name": "SMP Web Tools",
"logo": {
"@type": "ImageObject",
"url": "https://smp-web.com/logo.png"
}
},
"datePublished": "2026-01-15",
"dateModified": "2026-01-15"
}
2. WebSite
For your homepage. Enables sitelinks search box in Google.
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "SMP Web Tools",
"url": "https://smp-web.com/",
"potentialAction": {
"@type": "SearchAction",
"target": "https://smp-web.com/?q={search_term_string}",
"query-input": "required name=search_term_string"
}
}
3. Organization
For your business/brand. Adds logo to search results.
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "SMP Web Tools",
"url": "https://smp-web.com",
"logo": "https://smp-web.com/logo.png",
"sameAs": [
"https://twitter.com/smpwebtools",
"https://facebook.com/smpwebtools"
]
}
4. FAQPage
For pages with FAQ sections. Shows expandable Q&A in search results.
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [{
"@type": "Question",
"name": "What is SEO?",
"acceptedAnswer": {
"@type": "Answer",
"text": "SEO stands for Search Engine Optimization..."
}
}]
}
5. BreadcrumbList
Shows breadcrumb navigation in search results.
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://smp-web.com/"
},{
"@type": "ListItem",
"position": 2,
"name": "Blog",
"item": "https://smp-web.com/blog/"
}]
}
6. Product
For product pages. Shows price, rating, availability.
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Product Name",
"image": "https://smp-web.com/product.jpg",
"description": "Product description",
"offers": {
"@type": "Offer",
"price": "29.99",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
How to Add JSON-LD to Your Website
- Choose the appropriate schema type for your page
- Generate the JSON-LD code (use our free JSON-LD Schema Generator)
- Paste it in your page's
<head>or<body> - Test with Google Rich Results Test
- Validate with Schema.org Validator
- Monitor in Google Search Console โ Enhancements
๐ Skip the coding! Use our free JSON-LD Schema Generator to create structured data in seconds.
Where to Place JSON-LD
Google recommends placing JSON-LD in the <head> or <body>. Both work fine. You can also inject via Google Tag Manager.
Common Schema Mistakes
- Marking up content not visible on the page โ violates guidelines
- Wrong schema type โ using Article for a product
- Invalid JSON syntax โ missing commas or quotes
- Duplicate markup โ same schema multiple times
- Fake reviews โ can get you penalized
Testing Your Schema
Always test after adding:
- Google Rich Results Test
- Schema Markup Validator
- Google Search Console โ Enhancements
Final Thoughts
JSON-LD schema is one of the easiest SEO wins you can get. It takes 5 minutes to add, and the payoff โ rich snippets, higher CTR, better visibility โ is huge.
Start with the basics: WebSite schema on your homepage, Article schema on blog posts, and Organization schema site-wide. Then expand to FAQPage, Product, and Review schemas as needed.
Use our free JSON-LD Schema Generator to create valid schema in seconds โ no coding knowledge required.