The Complete Guide to Schema Markup (JSON-LD)
What Is Schema Markup?
Schema markup is a standardized vocabulary of tags you add to your HTML so search engines can understand what your content actually means, not just the words on the page. The vocabulary is maintained at schema.org, a project backed by Google, Microsoft, Yahoo, and Yandex. When you describe a page as an Article, a Product, or a Recipe in a machine-readable way, you give search engines the context they need to display rich results (also called rich snippets) such as star ratings, FAQ dropdowns, and breadcrumb trails.
Structured data does not directly boost your rankings. What it does is make your listing eligible for enhanced search features that can dramatically improve click-through rate and visibility.
JSON-LD vs Microdata vs RDFa
There are three syntaxes for adding structured data. They express the same schema.org vocabulary in different ways.
| Format | Where it lives | Google's stance |
|---|---|---|
| JSON-LD | A single <script> block, usually in the <head> |
Recommended |
| Microdata | Inline HTML attributes on your visible elements | Supported |
| RDFa | Inline HTML attributes (an extension of HTML5) | Supported |
Google explicitly recommends JSON-LD because it keeps your structured data in one place, separate from your markup. That makes it far easier to add, edit, and generate programmatically than microdata, which forces you to sprinkle attributes throughout your visible HTML.
Common Schema Types
You only need the types that match your content. These five cover most sites:
Article
Used for news, blog posts, and editorial content. Key properties include headline, author, datePublished, and image.
FAQPage
Marks up a list of questions and answers. Eligible pages can show expandable Q&A directly in search results.
Product
Describes an item for sale, including name, price, availability, and aggregateRating. This powers price and review snippets.
BreadcrumbList
Communicates the page's position in your site hierarchy, so Google can show a breadcrumb trail instead of a raw URL.
Organization
Describes your brand: name, logo, url, and social profiles. It helps establish your entity and can feed a knowledge panel.
Here is a minimal JSON-LD block for an article:
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "The Complete Guide to Schema Markup",
"author": { "@type": "Person", "name": "Jane Doe" },
"datePublished": "2026-07-13",
"image": "https://example.com/cover.png"
}
How to Add Schema to Your Page
- Choose the schema type that matches your content.
- Build the JSON-LD object with the required and recommended properties.
- Wrap it in a
<script type="application/ld+json">tag. - Place that script anywhere in the
<head>or<body>, either statically or injected at render time. - Make sure the structured data matches the visible content on the page.
You do not have to hand-write the JSON. A Schema Markup Generator can build valid JSON-LD for common types, and a JSON-LD Validator will confirm the syntax is correct before you ship it.
Testing Your Markup
Never publish structured data without testing it. Use these tools:
- Rich Results Test (Google) — checks whether your page is eligible for specific rich results.
- Schema Markup Validator (schema.org) — validates general syntax and vocabulary.
- Search Console — the Enhancements reports show live errors and warnings across your indexed pages.
Common Mistakes to Avoid
- Marking up content that is not visible to users. Structured data must reflect what is actually on the page.
- Missing required properties for a type, which makes the page ineligible for rich results.
- Fake or inflated review data, which violates Google's guidelines and can trigger a manual action.
- Forgetting to update dates and prices so the markup drifts out of sync with the page.
Conclusion
Schema markup is one of the highest-leverage technical SEO tasks you can do: it is invisible to visitors but tells search engines exactly what your page is about. Start with JSON-LD, add the types that fit your content, generate the code with a trusted tool, and always validate before you publish.
FAHAQ runs no ads and keeps everything free — donations are the only thing keeping the servers on. Even a couple of dollars helps.