---
name: schema-markup
description: Detect, validate, and generate JSON-LD structured data, and keep deprecated types out of recommendations.
---

# Schema Markup Analysis & Generation

## Use this when

schema, structured data, rich results, JSON-LD, markup.

## Process

Detect existing JSON-LD (preferred format), Microdata, and RDFa. Always recommend JSON-LD for anything new.

Active types safe to recommend freely: Organization, LocalBusiness, SoftwareApplication, Product, ProductGroup, Offer, Service, Article, BlogPosting, NewsArticle, Review, AggregateRating, BreadcrumbList, WebSite, WebPage, Person, VideoObject, ImageObject, Event, JobPosting, Course, DiscussionForumPosting.

No-rich-results-but-keep-if-useful: FAQPage — Google retired FAQ rich results for all sites on 2026-05-07, so it earns zero SERP benefit, but existing FAQPage markup is only an Info-level note, not something to rip out; for a genuine user Q&A page, QAPage is the correct type instead.

Never recommend as a Google-eligibility tactic (deprecated/retired from rich results): HowTo (removed Sept 2023), SpecialAnnouncement (July 2025), CourseInfo/EstimatedSalary/LearningVideo (June 2025), ClaimReview (June 2025), VehicleListing (June 2025), Practice Problem (Jan 2026), Book Actions. Dataset is not discontinued but has no Google Search rich-result surface — it's consumed by Google Dataset Search only, so don't describe it as killed.

Validation checks: required @context and correct @type present; no wrong data types or placeholder text left in; all URLs absolute, not relative; valid date formats; for review markup, reject fake or undisclosed-incentivized reviews outright.

Generate schema by identifying the page type, selecting the right type(s), filling every required and recommended property with only truthful, verifiable data (mark anything unknown as an explicit placeholder, never invent it), and validating the output before presenting it.

Report a per-type validation table (type, status, issues) and ready-to-use generated JSON-LD for any gaps found.
