Format: Technical but accessible (no-code focus)
Why Schema Markup Is Table Stakes
An AI agent reads your website in two ways:
1. Human-readable (what humans see) - Headlines, paragraphs, images - Takes time to parse
2. Machine-readable (structured data) - JSON-LD schema markup - AI can extract instantly - Unambiguous
If you have truth layer content but no schema markup, AI will miss 40% of it.
Here's exactly what to add.
What Is JSON-LD?
JSON-LD is a way to write data so machines understand it.
Example:
HUMAN READABLE:
"Our shoes cost $189 and come in sizes 5–15."
MACHINE READABLE (JSON-LD):
{
"@type": "Product",
"name": "ProStability Running Shoe",
"offers": {
"@type": "Offer",
"price": "189",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
},
"availableSizes": "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15"
}
Same information. Machine can extract the second one instantly.
5 Essential Schemas for Truth Layers
1. Product Schema (For Products/Services)
{
"@context": "https://schema.org",
"@type": "Product",
"name": "ProStability Running Shoe",
"description": "Stability running shoe designed for mild-to-moderate overpronators. Dual-density midsole, tested on 200 runners, 83% pain reduction.",
"brand": {
"@type": "Brand",
"name": "YourBrand"
},
"offers": {
"@type": "Offer",
"price": "189.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock",
"url": "https://yoursite.com/products/prostability-shoe"
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.6",
"ratingCount": "287"
},
"specs": [
{
"@type": "PropertyValue",
"name": "Midsole Material",
"value": "Dual-density foam (Shore A 65/50)"
},
{
"@type": "PropertyValue",
"name": "Weight",
"value": "8.7 oz (size 10 US men's)"
},
{
"@type": "PropertyValue",
"name": "Ideal For",
"value": "Mild-to-moderate overpronators"
}
]
}
Where to add this: In the <head> section of your product page
Tools to generate: schema.org generator, JSON-LD playground, or RankMath/Yoast (WordPress)
2. FAQPage Schema (For FAQ/Q&A)
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Is this shoe for overpronators?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Yes, specifically for mild-to-moderate overpronation (arch collapse 8–15°). If your arch collapses more, try our Stability-Plus model."
}
},
{
"@type": "Question",
"name": "How long do these shoes last?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Tested for 300+ miles before 10% material degradation. Average runner gets 6–8 months of use."
}
},
{
"@type": "Question",
"name": "What's the warranty?",
"acceptedAnswer": {
"@type": "Answer",
"text": "1 year manufacturer defect warranty. 30-day wear trial guarantee."
}
}
]
}
Where to add this: On FAQ pages, product pages with Q&A, blog posts with questions
Why it matters: Google and AI agents extract FAQ schema to understand your product better
3. HowTo Schema (For Tutorials/Guides)
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to Use JSON-LD Schema Markup for Truth Layers",
"description": "Step-by-step guide to adding machine-readable schema to your website",
"step": [
{
"@type": "HowToStep",
"name": "Identify Your Product Specs",
"text": "Document exactly what your product is, who it's for, and what it does. Be specific."
},
{
"@type": "HowToStep",
"name": "Choose the Right Schema Type",
"text": "Use Product schema for products, FAQPage for Q&A, HowTo for tutorials."
},
{
"@type": "HowToStep",
"name": "Write the JSON-LD",
"text": "Use schema.org generator or copy templates from this page."
},
{
"@type": "HowToStep",
"name": "Add to Your Website",
"text": "Paste into <head> section or use WordPress plugin (RankMath, Yoast)."
},
{
"@type": "HowToStep",
"name": "Test Your Markup",
"text": "Use Google Rich Results Test to verify your schema is valid."
}
]
}
Where to add this: On tutorial/guide pages, knowledge base articles
4. Organization/Person Schema (For Your Brand)
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "YourCompanyName",
"url": "https://yourcompany.com",
"logo": "https://yourcompany.com/logo.png",
"description": "We build AI-native products for teams under 50 people. Mission: make AI accessible to non-technical teams.",
"founder": {
"@type": "Person",
"name": "Founder Name",
"sameAs": "https://linkedin.com/in/founder"
},
"sameAs": [
"https://twitter.com/yourcompany",
"https://linkedin.com/company/yourcompany",
"https://github.com/yourcompany"
],
"contact": {
"@type": "ContactPoint",
"contactType": "Customer Support",
"telephone": "+1-XXX-XXX-XXXX",
"email": "support@yourcompany.com"
}
}
Where to add this: On your homepage (once per site)
Why it matters: Helps AI agents (and Google) understand your company identity
5. BreadcrumbList Schema (For Navigation)
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://yoursite.com"
},
{
"@type": "ListItem",
"position": 2,
"name": "Products",
"item": "https://yoursite.com/products"
},
{
"@type": "ListItem",
"position": 3,
"name": "Running Shoes",
"item": "https://yoursite.com/products/running-shoes"
},
{
"@type": "ListItem",
"position": 4,
"name": "ProStability",
"item": "https://yoursite.com/products/prostability"
}
]
}
Where to add this: On product/category pages
How to Add This to Your Website
Option 1: WordPress (Easiest)
- Install RankMath or Yoast SEO
- Go to each page's SEO settings
- Scroll to "Schema" section
- Fill in the fields (tool auto-generates JSON-LD)
- Publish
Option 2: WordPress (Manual)
- Go to page editor
- Paste JSON-LD in a Custom HTML block
- Wrap it in:
<script type="application/ld+json">...</script> - Publish
Option 3: Any Website (HTML)
- Open your page's HTML in code editor
- Find the
<head>section - Paste:
<script type="application/ld+json">+ your JSON-LD +</script> - Save and deploy
Option 4: Use a Generator
schema.org's generator tool
Google's Structured Data Markup Helper
JSON-LD Playground
Validation: Make Sure It Works
After adding schema, test it:
- Go to Google Rich Results Test
- Paste your page URL
- Wait for validation
- Fix any errors (usually typos or missing fields)
Green = good. Your schema is valid and Google/AI agents can read it.
Common Mistakes
Mistake 1: Wrong schema type - Product page uses Article schema - Blog post uses Product schema - Each page should use its most specific type
Mistake 2: Missing required fields - Product schema needs at least: name, price, currency - FAQPage needs: questions + answers - Incomplete schema won't validate
Mistake 3: Wrong JSON format - Missing closing braces - Wrong quotes (use " not ') - Syntax errors
Fix: Use a generator tool instead of manual JSON
Mistake 4: Not updating when content changes - Add schema once, never update it - If your product price changes, schema should too - Keep schema in sync with actual content
What AI Agents Extract From Schema
When an AI reads your page with proper schema, it extracts:
✓ Product specs (specifications, materials, dimensions)
✓ Pricing (actual cost, currency, availability)
✓ Ratings (customer feedback, review count)
✓ Comparisons (how you stack up to alternatives)
✓ FAQ (common questions and answers)
✓ Navigation (where this page fits in your site)
Without schema, AI has to guess this information from prose.
With schema, AI knows for certain.
Next Steps
- Identify 3 key pages (product pages, homepage, FAQ)
- Choose schema types (Product, FAQPage, Organization)
- Use a generator tool (RankMath, Yoast, or JSON-LD Playground)
- Test with Google Rich Results Test
- Deploy
This isn't optional anymore. Schema markup is how AI agents understand your truth layer.
Internal links: Truth Layer, Build Truth Layer, Agent-Legible Content
CTA: ARI audit (will show schema gaps)