⭐ Beginner — No coding experience needed
Schema Markup: A Beginner's Guide to JSON-LD
Learn what schema markup is, the four schemas that matter most, and how to add JSON-LD to any page without breaking your site.
What you will learn in this guide
- What schema markup actually does
- The four schemas that account for 90% of rich results
- How to add JSON-LD to a WordPress or static site
- How to validate before publishing
- Common mistakes and how to avoid them
1 What schema does
Schema markup is structured data that describes your page content to search engines. It enables "rich results" — the star ratings, FAQ accordions, recipe images and other enhanced listings you see in Google search.
Why it matters:Rich results take 30-80% more screen space than regular results and have 2-3x higher click-through rates. Adding schema to eligible pages is one of the highest-ROI SEO tasks.
2 The four schemas that matter most
| Schema | Use case | Rich result |
|---|---|---|
| Organization | Sitewide — your company info | Knowledge panel |
| Article | Blog posts and news | Top stories carousel, author byline |
| Product | Ecommerce products | Stars, price, availability |
| FAQPage | Pages with question/answer content | Expandable FAQ in search results |
Other schemas (HowTo, Recipe, Event, JobPosting, LocalBusiness, Video) are valuable for specific use cases but the four above cover most sites.
3 How to add JSON-LD
- 1Generate your schemaUse the Schema Builder at schema-tools.html#schema-builder. Pick the schema type, fill in the fields, and copy the generated JSON-LD.
- 2Paste into your page
<head>For WordPress: use a plugin like Yoast, Rank Math, or a custom field. For static sites: paste between<script type="application/ld+json">tags in the page head. - 3Validate with the Rich Results TestRun Google's tool on the page. Confirm: (1) schema parses, (2) page is eligible for rich results, (3) no warnings.
- 4Submit to Search ConsoleUse URL Inspection to request re-crawl of the page. Rich results usually appear within 1-7 days.
4 Common beginner mistakes
| Mistake | Fix |
|---|---|
| Schema describes different content than the page | Schema must match visible page content exactly |
| Required fields missing | Each schema type has required fields; check Schema.org docs |
| Duplicated FAQ schemas in the wrong order | One FAQPage per page maximum |
| Star ratings for the wrong entity | aggregateRating on Product means real customer reviews, not your own claim |
| Generic boilerplate copied across pages | Each page needs unique schema reflecting its actual content |
Don't add schema for invisible contentAdding FAQ schema to a page that doesn't actually show the FAQ to users is against Google's spam policy. Penalties for fake schema are severe.