Skip to content

Implementation guide · 2026

FAQPage is gone. Q&A content isn't. Mark it up like this.

Google killed FAQ rich results in May 2026. Q&A is still one of the most useful page formats — for users, for AI engines, and for accessibility. Here's the semantic HTML pattern we recommend, with the trade-offs spelled out.

PublishedMay 16, 202611 min read
Primary tool
Native
details/summary is the native HTML element for collapsible Q&A — supported in every modern browser since 2020
MDN Web Docs
100%
accessibility coverage: screen readers announce details/summary natively without ARIA
WCAG 2.2 + MDN
0
JavaScript required to make the pattern work — it's a static HTML feature
HTML Living Standard
Bing
still rewards FAQPage schema, so keep it on genuine FAQ pages if you care about Bing rich results
Microsoft Bing · Oct 2025

Chapter 01

Why this pattern, why now

FAQ content didn't get killed in May 2026 — only the rich-result schema reward did. Q&A is still one of the highest-utility content patterns on the web: it matches the way users phrase questions, it gives AI engines clear extraction units, and it gives screen reader users a predictable structure.

The mistake the SEO industry made was treating FAQPage JSON-LD as the goal instead of as one optional encoding. The actual goal is content that reads as questions and answers — and that goal is better served by semantic HTML than by JSON-LD, because semantic HTML benefits accessibility, AI extraction, and search simultaneously.

Joost de Valk's recommendation in May 2026 captured the shift: keep FAQ content where it's genuinely useful, drop FAQPage schema from pages where Q&A isn't the primary purpose, and use semantic HTML — the details and summary elements, plus question-style headings — as the primary representation. This article is the implementation guide for that recommendation.

We'll cover three patterns — collapsible disclosure, heading-based prose, and definition-list — plus when to keep JSON-LD, when to drop it, and how to test that screen readers and AI engines see what you intend.

GoalRight tool
User experience (collapsible Q&A)Native, accessible, zero JS<details>/<summary>
Long-form Q&A with prose answersh3 question + paragraphHeading-based pattern
Glossary or short Q→A pairsDefinition list semantics<dl>/<dt>/<dd>
AI extraction signalEngines parse the DOMQuestion-shaped heading text
Google rich resultExcept gov/healthNot available (post-May 2026)
Bing rich resultKeep if Bing mattersFAQPage JSON-LD still works
DOM
AI engines extract from the rendered DOM, not the @type — semantic HTML is the durable signal
Bing Webmaster guidance + RAG basics
Even when schema markup was helping, the engines were reading the visible content. The schema was a hint, not the data. After May 2026 the hint is mostly unread by Google — the visible content is doing the work either way.

Chapter 02

Pattern A — Collapsible disclosure

The default pattern. Use the details and summary elements when you have a list of Q&A pairs and the page is dense enough that users will want to scan. Screen readers announce these elements natively, the markup is self-contained, and you don't need a single line of JavaScript or ARIA.

Wrap the whole list in a section with an accessible name. The summary holds the question. The body of the details holds the answer — and it can contain anything: paragraphs, code, lists, even further nested details. The open state can be controlled via the open attribute on the first item if you want it expanded by default.

The one gotcha: don't put interactive elements inside the summary (links, buttons). Modern browsers handle it but old assistive tech can choke. Keep the summary text-only and put any links inside the body.

BehaviorPattern AWhen to pick it
Visual stateCollapsed by defaultDense FAQ pages, ≥4 items
AccessibilityNative, no ARIAAlways — start here
JS requiredNoneStatic-friendly
AnimationBrowser-native + CSS @starting-styleOptional, progressive enhancement
AI extractionSummary text reads as a questionEngines parse the visible DOM
Native
the disclosure pattern is built into HTML — using it correctly is more reliable than any custom JS implementation
HTML Living Standard · §4.11.1
0 KB
JavaScript footprint required — relevant for INP and Core Web Vitals
web.dev
Minimal correct disclosure FAQ
Code
<section aria-labelledby="faq">
  <h2 id="faq">Frequently asked questions</h2>
  <details>
    <summary>How long does setup take?</summary>
    <p>About five minutes for a single site, longer for multi-domain accounts.</p>
  </details>
  <details>
    <summary>Is there a free tier?</summary>
    <p>Yes — the beta is free for individual sites with a single user.</p>
  </details>
</section>
Reference pattern · MDN-compatible

Chapter 03

Pattern B — Heading-based prose

When answers are long, when context matters, and when the FAQ is really an essay disguised as Q&A, the heading-based pattern beats the disclosure widget. Each question becomes an h3 (or h2, depending on outline), each answer is a paragraph or several. The page reads top to bottom, the table of contents is automatic, and search engines have an easier time identifying the answer span.

This is the right pattern for help center articles, expert Q&A interviews, and any FAQ where the answer benefits from being immediately visible. It's also the pattern AI engines tend to extract from most cleanly — the question heading becomes the anchor, the prose underneath is the answer span.

If you want both an overview and depth, combine the patterns: a disclosure block at the top for fast scanning, followed by heading-based sections for the long answers. Keep the same question text in both places so the page reads consistently.

NeedPattern BVersus Pattern A
Answers longer than 2-3 sentencesStrong fitPattern A hides them by default
Page is the answer (not a list)Strong fitPattern A overstructures
Search snippet targetHeading + paragraph parses cleanlyPattern A also works
AI citation surfaceStable extractionEqual — engines read DOM
Table of contentsFree from heading outlinePattern A requires custom
h2/h3
question-shaped headings are the strongest semantic signal — engines and screen readers both rely on them
WCAG 2.4.6 + GSC docs
Equal
AI engines treat heading-based Q&A and disclosure Q&A as roughly equivalent for extraction
Princeton GEO paper · pattern-agnostic findings

Chapter 04

Three traps to avoid

Trap — Re-inventing disclosure with divs
Custom <div>+<button>+aria-expanded works but is harder to keep accessible across browsers, assistive tech updates, and component refactors. <details>/<summary> is the durable choice. Reach for the custom build only when you need behaviors the native element can't do.
Trap — Keeping FAQPage JSON-LD on non-FAQ pages
If your product page or blog post has three Q&A items at the bottom, that page is not an FAQPage. Schema should describe the page accurately. Joost de Valk's argument: schema-content honesty is the discipline that prevents the next deprecation cycle.
Trap — Putting question text only in JSON-LD
Some implementations hide Q&A behind a tab and ship the full content only in JSON-LD. Google's own docs prohibit it. AI engines extract from the visible DOM. If a question doesn't appear in the rendered page, it doesn't exist for AI extraction either.

Chapter 05

Migration playbook

01
Audit every page with FAQPage schema
Find every page emitting FAQPage JSON-LD. For each: confirm the page is genuinely a FAQ (Q&A is the primary purpose, content is honestly described). Keep schema where it's honest, remove where it isn't.
Joost's recommendation
02
Convert custom accordions to <details>
If you have a custom React/Vue accordion component that wraps each FAQ, replace it with semantic <details>/<summary>. You'll likely cut JS, win on accessibility, and avoid CLS issues. Animations can stay via CSS @starting-style.
MDN · WCAG
03
Promote inline Q&A to heading-based
On help center articles and long-form FAQ posts, switch from collapsible widgets to heading-based prose. The page becomes scannable from the outline, search snippets get cleaner targets, and AI engines extract spans more reliably.
AI extraction basics
04
Decide on Bing-only JSON-LD
Bing still rewards FAQPage rich results per its October 2025 guidance. On pages where the JSON-LD is honest, keeping it is free for Bing visibility. On pages where it isn't honest, drop it — even for Bing.
Microsoft · Oct 2025
05
Test with a screen reader
Run VoiceOver (Mac), NVDA (Windows), or TalkBack (Android) on every FAQ pattern you ship. <details>/<summary> should announce as "summary, button" and toggle correctly. Custom accordions often fail this and you only notice with a real screen reader.
WCAG 4.1.2
06
Update analyzer rules
If your SEO tooling still tells you to add FAQPage everywhere, recalibrate. That SEO Agent is shipping a semantic-Q&A check that rewards correct HTML patterns and flags schema-content mismatches.
Our roadmap

Chapter 06

What changes in our analyzer

Our GEO and AI Visibility analyzers currently reward FAQPage schema heavily. After the May 2026 deprecation and the Ahrefs causal study, we're shifting weight toward what actually carries the signal: semantic Q&A HTML patterns in the rendered DOM. Below is the new check shape.

Reward semantic Q&A patterns
Detect <details>/<summary>, question-shaped headings, and definition lists. Award points for visible Q&A structure independent of JSON-LD.
Detect schema-content mismatch
Flag FAQPage JSON-LD on pages without a visible FAQ section. The reason FAQ rich results died was abuse — and abuse is detectable from a single page render.
Score by honesty, not coverage
More schema is not better. Honest, narrow schema that matches the page beats broad schema every time. Our score should reflect that, and it will.
Primary sources
Official platform docs
MDN Web Docs — <details> element referencedeveloper.mozilla.org
HTML Living Standard — Interactive elements (§4.11)html.spec.whatwg.org
Google Search Central — FAQPage structured data (May 2026 deprecation)developers.google.com
Microsoft — Optimizing for AI search answers (Oct 2025)ads.microsoft.com
Industry analysis
Joost de Valk — The FAQ schema cycle (May 2026)joost.blog
Ahrefs — Does schema markup help with AI citations? (causal study, 2026)ahrefs.com
Standards & studies
WCAG 2.2 — Web Content Accessibility Guidelines (W3C Recommendation)w3.org/TR/WCAG22
Aggarwal et al. — GEO: Generative Engine Optimization (KDD 2024)arxiv.org/abs/2311.09735

Audit your FAQ implementation

Ship Q&A content the engines and screen readers actually read.

That SEO Agent's analyzer is being upgraded to reward semantic Q&A HTML and flag schema-content mismatches. Run an audit on your FAQ pages and see what's working — and what's quietly invisible.

Free during beta · Semantic HTML aware

THAT SEO AGENT

44 SEO tools for Claude, ChatGPT & Cursor. Connect GSC, GA4, and PageSpeed. Stop briefing AI about your own site.

That SEO Agent - Stop briefing AI about your own site. | Product HuntThat SEO agent - Featured on Builders.to
© 2026 THATSEOAGENT.COM · ALL RIGHTS RESERVEDBUILT WITH ♥ FOR SEO PROFESSIONALS