seo-schema

Schema.org JSON-LD

Workflow

1. Detect existing JSON-LD blocks in HTML
2. Run scripts/validate-schema.ts → check against schema.org offline dumps
3. Identify missing schema types based on page type
4. Generate from templates in templates/json-ld/

Supported Types

Type	Use Case	Template
Article	Blog posts, news	templates/json-ld/article.json
Product	E-commerce	templates/json-ld/product.json
LocalBusiness	Local SEO	templates/json-ld/localbusiness.json
Organization	Brand/company pages	templates/json-ld/organization.json
BreadcrumbList	Navigation	templates/json-ld/breadcrumb.json
FAQPage	Q&A (gov/health only since Aug 2023)	templates/json-ld/faq.json
VideoObject	Video content	templates/json-ld/video.json
Event	Events	templates/json-ld/event.json
Recipe	Recipes	templates/json-ld/recipe.json

Deprecations (2025)

• HowTo: Deprecated September 2023
• FAQ: Restricted to government/health sites since August 2023
• SpecialAnnouncement: Deprecated July 2025

References

• skills/seo/03-schema-org/ (all 9 schema docs)