Schema markup: what, why, and how

The foundation of rich results, AI understanding, and search visibility. Everything you need to know about structured data, in one place.

Last updated: 2026-10-10

What a page tells them, once it is marked up

What it is
A pricing page
Who publishes it
Crewline
Price
$49 per seat, per month
Billing
Annual

Read from the page itself, not guessed at.

What is schema markup?

Schema markup is a standardized vocabulary created by Schema.org (a collaboration between Google, Microsoft, Yahoo, and Yandex) that helps search engines and AI understand the meaning and context of your content.

Think of schema as metadata for machines. While humans see a blog post, search engines see HTML code. Schema bridges that gap by explicitly defining: "This is an Article. This is the headline. This is the author. This is when it was published."

Without it, a search engine is guessing.

Without schema, search engines guess based on HTML patterns. With schema, you explicitly tell them: "This is a product. Here's the price. Here's the rating. Here's availability." No guessing. No ambiguity. Just structured, machine-readable data.

Schema markup is typically implemented using JSON-LD (JavaScript Object Notation for Linked Data), a format Google explicitly recommends.

An Article, described in JSON-LD
Sits in the head of the page it describes
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Your Article Title",
  "author": {
    "@type": "Person",
    "name": "Jane Doe"
  },
  "datePublished": "2025-01-10"
}
</script>

This tells search engines: "This page contains an Article. The headline is 'Your Article Title.' The author is Jane Doe. It was published on January 10, 2025." Clear. Structured. Unambiguous.

Schema.org provides over 1,000 types covering articles, products, events, recipes, FAQs, organizations, people, places, and more. Each type has specific properties that define its attributes.

Why it matters

Schema markup isn't just "nice to have" - it's a competitive advantage. Here's why it matters for SEO, rich results, and AI visibility:

Rich Snippets & Enhanced Search Results

Schema enables rich results: star ratings, recipe cards, event details, FAQ accordions, product pricing, and more. Pages with rich snippets get 58% of clicks compared to 41% for non-rich results. Schema = higher visibility, higher CTR.

Entity Understanding & Knowledge Graph

Schema helps Google understand entities - people, places, organizations, products - and their relationships. This powers knowledge panels, entity carousels, and "People also ask" boxes. Schema makes your brand a recognized entity, not just a website.

AEO & AI Search Readiness

AI-powered search engines (ChatGPT, Perplexity, Google AI Overviews) rely on structured data to understand and cite content. Schema makes your content 434% more likely to appear in AI-generated answers. Without schema, you're invisible to AI search.

Voice Search Optimization

Voice assistants (Alexa, Google Assistant, Siri) pull answers from schema-rich content. FAQPage schema directly answers voice queries. HowTo schema provides step-by-step instructions. Schema is how you win voice search.

Schema isn't optional anymore. It's how search engines and AI understand your content. Implement it correctly, and you get rich results, higher CTR, AI citations, and entity recognition. Skip it, and you're competing with one hand tied behind your back.

With it and without it

What changesWithout schemaWith schema
Rich Snippet Eligibility 0% - Not eligible Eligible for all types
Click-Through Rate 41% average CTR 58% average CTR (+41%)
AI Citation Probability Low - AI must guess 434% more likely
Knowledge Graph Not recognized as entity Entity recognition
Voice Search Rarely selected Featured answers

The three formats

The same fact about the same article, written three ways. Google reads all three and recommends one.

FormatWhere it goesGoogleTo writeTo maintain
JSON-LD Separate <script> tag Recommended Easy - doesn't touch HTML Simple updates
Microdata Inline HTML attributes Supported Medium - requires HTML changes More complex
RDFa Inline HTML attributes Supported Complex - verbose syntax Most complex
JSON-LD
Separate <script> tag
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Your Article Title"
}
</script>
Microdata
Inline HTML attributes
<article itemscope itemtype="https://schema.org/Article">
  <h1 itemprop="headline">Your Article Title</h1>
</article>
RDFa
Inline HTML attributes
<article vocab="https://schema.org/" typeof="Article">
  <h1 property="headline">Your Article Title</h1>
</article>

How to implement it

1 Generate Your Schema

Create structured data using AI or manually. SuperSchema's AI reads your content and generates optimized markup automatically.

  • Use SuperSchema to auto-detect schema types
  • Or write JSON-LD manually following Schema.org specs
  • Include all required properties for your chosen type
  • Add recommended properties for richer results
2 Validate Your Markup

Test schema before deploying. Validation catches syntax errors, missing properties, and compliance issues.

  • Use Google Rich Results Test for preview
  • Check Schema.org Validator for spec compliance
  • SuperSchema auto-validates and scores quality
  • Fix all critical errors before deployment
3 Embed Schema in Your HTML

Add JSON-LD to your page's <head> or <body>. Most platforms support schema injection via plugins or custom code.

  • Place JSON-LD script in <head> section
  • Or add before closing </body> tag
  • Use SuperSchema's HubSpot integration for one-click deployment
  • Ensure schema loads on every relevant page
4 Test & Monitor Results

Verify implementation and track rich results in search. Schema benefits appear gradually as search engines re-crawl.

  • Check Google Search Console for rich result reports
  • Monitor "Enhancements" section for errors
  • Re-validate after CMS or theme updates
  • Track CTR improvements for schema-enhanced pages

What Google asks for

JSON-LD is Preferred

Google explicitly recommends JSON-LD over Microdata and RDFa. It's cleaner, easier to maintain, and doesn't require HTML changes. Stick with JSON-LD.

Schema Must Match Visible Content

Never mark up content that users can't see. Schema must reflect what's actually on the page. Lying to search engines violates guidelines and triggers penalties.

Avoid Duplicate Schema

One schema block per type per page. Multiple Article schemas or conflicting data confuses search engines. Consolidate into one comprehensive block.

Keep Schema Updated

CMS updates, theme changes, and plugin updates can break schema. Re-validate after any major site changes. Monitor Google Search Console for schema errors.

Include All Required Properties

Each schema type has required properties. Missing them prevents rich results. Check Schema.org documentation or use SuperSchema to auto-include required fields.

Common mistakes, and how to fix them

Invalid JSON Syntax
What goes wrong
One missing comma, bracket, or quote breaks the entire schema. Search engines ignore broken markup.
What to do
Always validate with Google Rich Results Test. Use SuperSchema to generate error-free JSON-LD automatically.
Schema Doesn't Match Visible Content
What goes wrong
Marking up content that users can't see violates Google's guidelines and risks penalties.
What to do
Only mark up content that's visible on the page. Schema must reflect what users actually see. Never lie to search engines.
Missing Required Properties
What goes wrong
Each schema type has required properties. Missing them prevents rich results from appearing.
What to do
Check Schema.org documentation for required properties. SuperSchema highlights missing fields and suggests fixes.
Duplicate or Conflicting Schema
What goes wrong
Multiple schema blocks of the same type confuse search engines and dilute signals.
What to do
Consolidate into one comprehensive schema block per type. Remove duplicate or plugin-generated schema.
Using Deprecated Schema Types
What goes wrong
Old schema types lose support. Deprecated properties don't trigger rich results.
What to do
Stay updated with Schema.org changelog. SuperSchema uses current spec and warns about deprecated types.
Ignoring Validation Errors
What goes wrong
Warnings and errors prevent rich results. "It's just a warning" means "it won't work."
What to do
Fix all errors and warnings before deployment. Treat validation seriously - your rich results depend on it.

The schema types that matter here

Questions people ask

Get valid JSON-LD without writing it.

A free account. Your first page fixed free, with no card. It needs a paid HubSpot plan.