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.
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.
| Goal | Right tool |
|---|---|
| User experience (collapsible Q&A)— Native, accessible, zero JS | <details>/<summary> |
| Long-form Q&A with prose answers— h3 question + paragraph | Heading-based pattern |
| Glossary or short Q→A pairs— Definition list semantics | <dl>/<dt>/<dd> |
| AI extraction signal— Engines parse the DOM | Question-shaped heading text |
| Google rich result— Except gov/health | Not available (post-May 2026) |
| Bing rich result— Keep if Bing matters | FAQPage JSON-LD still works |
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.
| Behavior | Pattern A | When to pick it |
|---|---|---|
| Visual state | Collapsed by default | Dense FAQ pages, ≥4 items |
| Accessibility | Native, no ARIA | Always — start here |
| JS required | None | Static-friendly |
| Animation | Browser-native + CSS @starting-style | Optional, progressive enhancement |
| AI extraction | Summary text reads as a question | Engines parse the visible DOM |
<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>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.
| Need | Pattern B | Versus Pattern A |
|---|---|---|
| Answers longer than 2-3 sentences | Strong fit | Pattern A hides them by default |
| Page is the answer (not a list) | Strong fit | Pattern A overstructures |
| Search snippet target | Heading + paragraph parses cleanly | Pattern A also works |
| AI citation surface | Stable extraction | Equal — engines read DOM |
| Table of contents | Free from heading outline | Pattern A requires custom |
Chapter 04
Three traps to avoid
Chapter 05
Migration playbook
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.
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