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.
<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 changes | Without schema | With 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.
| Format | Where it goes | To write | To 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 |
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your Article Title"
}
</script> <article itemscope itemtype="https://schema.org/Article"> <h1 itemprop="headline">Your Article Title</h1> </article>
<article vocab="https://schema.org/" typeof="Article"> <h1 property="headline">Your Article Title</h1> </article>
How to implement it
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
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
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
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
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.
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.
One schema block per type per page. Multiple Article schemas or conflicting data confuses search engines. Consolidate into one comprehensive block.
CMS updates, theme changes, and plugin updates can break schema. Re-validate after any major site changes. Monitor Google Search Console for schema errors.
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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
How to check your markup
- Google Rich Results Test Google's official tool shows how your schema will appear in search results. Tests eligibility for rich snippets and highlights errors.
- Schema.org Validator Official Schema.org validation tool. Checks compliance with spec, identifies syntax errors, and validates property values.
- SuperSchema Quality Scoring Our AI validates schema and provides quality scores (0-100). Highlights missing properties, suggests optimizations, and auto-fixes common errors.
The schema types that matter here
- FAQ Schema Q&A content structured data
- Article Schema News, blog posts, guides
- BlogPosting Schema Blog-specific markup
- HowTo Schema Step-by-step instructions
- Product Schema E-commerce products
- LocalBusiness Schema Physical locations
- Organization Schema Company information
- Event Schema Events and webinars
- Review Schema Product/business reviews
- Breadcrumb Schema Site navigation
Deep dive guides
- JSON-LD vs Microdata Complete comparison guide with migration steps and why JSON-LD is better for modern SEO and AEO
- Improve Schema Quality Score Best practices for schema markup that validates and performs well in search
Apply schema to a real page
Use an example that matches the page's purpose, then check both the markup and the facts it describes.
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.