# JSON-LD Schema Markup for Truth Layers: Copy-Paste Templates
**Primary keyword:** JSON-LD schema markup truth layers
**Secondary keywords:** product schema for AI, structured data templates
**Length:** 2,000 words
**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)
```json
{
"@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 `
` 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)
```json
{
"@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)
```json
{
"@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
},
{
"@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)
```json
{
"@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)
```json
{
"@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)
1. Install **RankMath** or **Yoast SEO**
2. Go to each page's SEO settings
3. Scroll to "Schema" section
4. Fill in the fields (tool auto-generates JSON-LD)
5. Publish
### Option 2: WordPress (Manual)
1. Go to page editor
2. Paste JSON-LD in a **Custom HTML block**
3. Wrap it in: ``
4. Publish
### Option 3: Any Website (HTML)
1. Open your page's HTML in code editor
2. Find the `
3. Paste: ``
4. Save and deploy
### Option 4: Use a Generator
[schema.org's generator tool](https://schema.org/)
[Google's Structured Data Markup Helper](https://www.google.com/webmasters/markup-helper/)
[JSON-LD Playground](https://json-ld.org/playground/)
---
## Validation: Make Sure It Works
After adding schema, test it:
1. Go to [Google Rich Results Test](https://search.google.com/test/rich-results)
2. Paste your page URL
3. Wait for validation
4. 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
1. **Identify 3 key pages** (product pages, homepage, FAQ)
2. **Choose schema types** (Product, FAQPage, Organization)
3. **Use a generator tool** (RankMath, Yoast, or JSON-LD Playground)
4. **Test with Google Rich Results Test**
5. **Deploy**
This isn't optional anymore. Schema markup is how AI agents understand your truth layer.
---
**Word count:** 2,000
**Internal links:** Truth Layer, Build Truth Layer, Agent-Legible Content
**CTA:** ARI audit (will show schema gaps)