Schema Markup
Add or fix schema.org structured data so pages show enhanced results in Google and get parsed correctly by AI.
Schema markup is the structured data that earns star ratings, FAQ rich results, and breadcrumb trails in search. Done well it lifts CTR; done badly it triggers manual penalties and confuses AI engines that depend on structured signals.
Who it's for: SEO managers, technical marketers, web teams shipping rich results, ecommerce marketers, content publishers
Example
"Add FAQ schema to our blog posts" → JSON-LD blocks, validation against Google's rich results test, deployment guidance, and a monitoring plan to catch breakage
CLAUDE.md Template
New here? 3-minute setup guide → | Already set up? Copy the template below.
npx ccplaybooks add schema-markup---
name: schema-markup
description: When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions "schema markup," "structured data," "JSON-LD," "rich snippets," "schema.org," "FAQ schema," "product schema," "review schema," "breadcrumb schema," "Google rich results," "knowledge panel," "star ratings in search," or "add structured data." Use this whenever someone wants their pages to show enhanced results in Google. For broader SEO issues, see seo-audit. For AI search optimization, see ai-seo.
metadata:
version: 1.1.0
---
# Schema Markup
You are an expert in structured data and schema markup. Your goal is to implement schema.org markup that helps search engines understand content and enables rich results in search.
## Initial AssessmentGet new playbooks like this one
One email a week with new Claude Code workflows. Free, like everything here.
No spam. Unsubscribe anytime.
What This Does
Implements schema.org structured data that helps search engines understand content and enables rich results — FAQ, HowTo, Article, Product, Review, Breadcrumb, Organization — and stays valid over time.
Quick Start
Step 1: Create a Project Folder
Create a dedicated folder for this workflow (e.g. ~/marketing/schema-markup).
Step 2: Download the Template
Click Download above and save the file as CLAUDE.md in that folder.
Step 3: Run the Workflow
Share the page type and any existing schema, and describe the rich result you're targeting.
Inputs You'll Need
- Page type — article, product, recipe, FAQ, how-to, organization
- Existing schema — current implementation if any
- Goals — which rich result(s) you want to earn
- CMS / framework — to recommend implementation approach
How It Works
- Map content to the right schema types
- Generate JSON-LD blocks with required and recommended fields
- Validate with Google Rich Results Test and Schema Validator
- Provide deployment instructions for the CMS or framework
- Recommend monitoring (Search Console rich results report, periodic re-validation)
What You Get
- JSON-LD blocks for each page or template
- Validation results
- Deployment instructions
- Monitoring plan to catch regressions