FAQ pages include FAQPage schema with questions and answers
Why it matters
FAQ pages with visible Q&A content but no FAQPage schema forfeit an outsized SERP feature: Google expands FAQ Rich Results below the title link, sometimes doubling the vertical SERP footprint of a single result. The schema-org FAQPage and Question types are explicitly supported by Google for this expansion. A site with 10 FAQ questions that omits schema loses this real estate to any competitor who implements it. The mismatch between visible content and schema mainEntity is a common AI-generated defect — questions get hardcoded in markup but the schema block is never updated.
Severity rationale
Medium because FAQ Rich Results expand SERP footprint significantly, but the failure affects only pages with FAQ content and doesn't break core site functionality.
Remediation
Sync your FAQ schema mainEntity array to exactly match the visible questions rendered on the page. In app/faq/page.tsx, generate the schema from the same data source that populates the UI — never maintain them separately:
const faqs = [
{ q: 'What is your return policy?', a: 'We offer 30-day returns with original receipt.' },
{ q: 'Do you ship internationally?', a: 'Yes, to 45 countries via DHL Express.' },
]
const schema = {
'@context': 'https://schema.org',
'@type': 'FAQPage',
mainEntity: faqs.map(({ q, a }) => ({
'@type': 'Question',
name: q,
acceptedAnswer: { '@type': 'Answer', text: a },
})),
}
Each Question requires both name and acceptedAnswer. Validate that schema question count matches visible page question count before deploying.
DetectionPro
The detection method for this pattern is part of AuditBuffet Pro.
The full method (what to look for, pass and fail conditions, and how results get reported) ships inside the Advanced SEO Audit. The pattern definition, severity rationale, and remediation remain openly licensed under CC-BY-4.0.
External references
- schema-org · FAQPage — FAQPage type with mainEntity Question array
- schema-org · Question — Question with acceptedAnswer property
Taxons
History
- 2026-04-18·v1.0.0·Initial import from seo-advanced·automated