FAQ schema explained: FAQPage JSON-LD, the end of FAQ rich results in Google in May 2026, a code example, common mistakes and why visible FAQs still help AI.

In short
FAQ schema is structured data (usually JSON-LD) that uses the schema.org FAQPage type to label the questions and answers on a page. Google restricted FAQ rich results to government and health sites in August 2023, then stopped showing them for all sites on May 7, 2026. The markup remains valid and harmless, and Google still uses structured data to understand pages, but it no longer produces a visual result: the value now lies in a well-written, visible FAQ that Google and AI assistants can quote.
Want to go further? Ask
FAQ schema was for years one of the easiest SEO wins: a few lines of code, and your questions appeared as expandable answers under your result. That era is over. Google's Search Central documentation updates record the deprecation of the FAQ rich result in May 2026 and the removal of its documentation in June 2026. This guide explains what the markup is, what changed, when it is still worth adding, and how to write FAQs that get cited.
FAQ schema is a block of schema markup that describes a list of questions and their answers in a machine-readable format. It relies on three types from the shared schema.org vocabulary, created by Google, Microsoft, Yahoo and Yandex:
The questions are listed in the mainEntity property of the page. Google recommends JSON-LD for structured data whenever the site allows it, because the code sits in one block, separate from the visible HTML.
The two types are often confused. The difference depends on who writes the answers.
| Criterion | FAQPage | QAPage |
|---|---|---|
| Who writes the answer | The site owner | Users of the site |
| Answers per question | One official answer | Several answers, possibly voted |
| Typical page | Product page, service page, help article, blog post | Forum thread, community question page |
| Example | "How long does delivery take?" answered by the store | "Which laptop for video editing?" answered by members |
FAQ rich results showed questions as dropdowns directly in the search results, which made a result taller and pushed competitors down. Their decline happened in two steps.
| Date | Change | Effect for site owners |
|---|---|---|
| 2019 | Google launches FAQ rich results | Any site with valid FAQPage markup can get expandable questions |
| August 8, 2023 | Visibility reduced | Shown only for well-known, authoritative government and health websites |
| May 7, 2026 | Feature retired | FAQ rich results no longer appear in Google Search for any site |
| June 2026 | Documentation and reports removed | FAQ report, search appearance filter and Rich Results Test support dropped |
| August 2026 | API support removed | FAQ data no longer available in the Search Console API |
In its August 2023 announcement, Google stated that there is no need to remove the markup proactively: "Structured data that's not being used does not cause problems for Search, but also has no visible effects in Google Search." The same logic applies after the 2026 retirement. Google also specified that the change was not a ranking change: losing the rich result can lower click-through rate, but not the position itself.
Yes, when the page already has a real FAQ, because the cost is close to zero. No, if you expect a visual result or a ranking boost. Here is what the markup still does, and what it does not do.
Claims that FAQ schema multiplies AI citations circulate widely, but no public study from Google, OpenAI or another primary source confirms them. What AI assistants quote is the visible text: a clear question followed by a direct answer. Our guide to structured data for AI search sorts the markup that helps from the markup that does not.
An FAQ earns its place when visitors have recurring questions that the main content does not answer. It is a poor fit for pages whose content is already a single answer.
| Page type | Typical questions | FAQ useful? |
|---|---|---|
| Service page | Price, timeline, process, guarantees | Yes, it handles objections before contact |
| Product page | Sizing, compatibility, delivery, returns | Yes, if the questions are specific to the product |
| Pricing page | Billing, cancellation, plan differences | Yes, one of the most read blocks |
| Blog guide | Related questions not covered by the headings | Yes, 3 to 5 questions at the end |
| Help center | One question per article | The article itself is the answer |
| Contact or legal page | Rarely searched questions | Usually not |
Pick 3 to 8 questions your visitors actually ask: support tickets, sales calls, the "People also ask" box, related searches (see our guide to People Also Search For). Answer each one in 2 to 4 sentences, starting with the answer itself.
The structure is always the same. A minimal example with one question:
{"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "How long does delivery take?", "acceptedAnswer": {"@type": "Answer", "text": "Orders ship within 24 hours and arrive in 2 to 4 business days."}}]}
Each additional question is a new Question object in the mainEntity list. The block goes inside a script tag of type application/ld+json, in the head or the body of the page. To avoid syntax errors, a free FAQ schema generator builds the code from your questions, and a general schema generator covers the other types (Article, Product, Organization).
On WordPress, SEO plugins such as Yoast offer an FAQ block that outputs the markup automatically; the same logic applies to the WordPress optimization options we document. On Shopify, Webflow or Wix, paste the JSON-LD into a custom code field of the template or page.
Since June 2026, Google's Rich Results Test no longer checks FAQ markup. Use the Schema Markup Validator from schema.org or our structured data validator to catch syntax errors, missing properties and mismatches with the visible text.
The rich result is gone, but the FAQ format remains one of the most useful blocks on a page, for search engines and for generative engine optimization (GEO). A good FAQ captures long-tail questions that the main text does not cover, matches the way people phrase prompts in ChatGPT or Gemini, and gives AI assistants short, self-contained passages they can quote with a link. Sorank's study of the sources Gemini cites and our explanation of how search engines work point the same way: the page must first be crawled, indexed and ranked, then a clear answer gets picked.
To check whether your markup is readable by language models, run a structured data audit for LLMs. To see whether your FAQs lead to citations, track your brand mentions in AI answers on the questions your customers ask.
FAQ schema no longer earns a visual result in Google, but a visible, well-answered FAQ still earns clicks, snippets and AI citations. Keep the markup where you have a real FAQ, remove nothing in a hurry, and invest your time in the answers themselves. If you want articles that already include sourced, question-based sections, Sorank's article generator writes and publishes them on autopilot; see how Sorank works.
No, there is no need to remove it. Google has stated that structured data that is not used does not cause problems for Search. Keep it on pages with a real, visible FAQ, and remove it only where it describes content that no longer exists on the page.
Not directly. Google states that no special markup is required to appear in AI Overviews or AI Mode: the page must be indexed and eligible to show a snippet. A visible question followed by a clear, self-contained answer is what can be picked and quoted.
Yes, if the questions and answers are written by you and visible on the product page, for example sizing, compatibility or delivery questions. If shoppers write the answers, as in a community Q&A section, the QAPage type fits better. Avoid repeating the same generic FAQ on every product.
THEY TRIED SORANK BEFORE YOU
