FAQ Schema: Implementation Guide for Rich Results

No Comments
Faq schema: implementation guide for rich results

AI Summary

FAQ schema (FAQPage JSON-LD) marks up genuine question and answer pairs that are visible on the page so search engines can read them as structured data. Since 2023 Google shows FAQ rich results mainly for authoritative government and health sites, but valid markup still helps AI answer engines, voice assistants, and internal quality signals.

  • Use FAQPage only for author written questions that are visible on the page, never for user generated Q&A (use QAPage) or ads.
  • Each Question needs a name plus an acceptedAnswer with a text property; keep answers concise and complete.
  • Rich result display is not guaranteed, so treat schema as an extraction aid for AI and voice, not a ranking lever.
  • Validate with the Rich Results Test and monitor the FAQ report in Search Console Enhancements.
Diagram showing visible faq content on a page converted into faqpage json-ld markup and surfaced as a search rich result and ai citation.
How visible FAQ content becomes FAQPage structured data and then a rich result or AI answer.

Understanding FAQ Schema

FAQPage schema markup enables expanded question-and-answer displays directly in search results, significantly increasing your listing's visual footprint. When implemented correctly, FAQ rich results show questions that users can click to expand and see answers without leaving the search results page. This feature works particularly well for service pages, product pages, and informational content where common questions naturally arise. However, Google has become selective about displaying FAQ rich results, primarily showing them for authoritative sites.

Eligibility and Guidelines

Google's guidelines for FAQ rich results have tightened. FAQPage is now primarily eligible for well-known, authoritative government and health websites for relevant queries. Other sites may still implement FAQ markup, but rich result display is not guaranteed. Content must genuinely answer common questions, be written by the site (not user-generated), and be visible on the page. Each question should be unique and provide substantive value. Avoid using FAQ schema for promotional content, contact forms, or navigation elements disguised as questions.

Eligible ContentIneligible Content
Genuine frequently asked questionsUser-generated Q&A (use QAPage instead)
Product/service FAQsSingle question pages
How-to questions with brief answersAdvertising disguised as FAQ
Company/policy informationQuestions not visible on page

Implementation Structure

FAQPage schema requires a mainEntity property containing an array of Question entities. Each Question needs name (the question text) and acceptedAnswer containing an Answer entity with text property. The answer text supports limited HTML including links, lists, and paragraph breaks. Keep answers concise but complete, as excessively long answers may be truncated or the rich result may not display. Structure your JSON-LD with the FAQPage as the root type, not nested within Article or other schemas.

Content Strategy for FAQ Sections

Effective FAQ content addresses genuine user questions discovered through customer service data, search query analysis, and competitor research. Group related questions logically on appropriate pages rather than creating one massive FAQ page. Product pages benefit from product-specific FAQs, while service pages need service-related questions. Avoid duplicating FAQ content across pages, as this can create thin content issues. Update FAQs regularly based on new questions from users and changes to your products or services.

Measuring FAQ Performance

Google Search Console's Enhancements section shows FAQ rich result status, including valid pages, warnings, and errors. Track click-through rates for pages with FAQ markup to assess impact. Note that rich result impressions don't always correlate with clicks, as users may find answers directly in the expanded FAQ without clicking through. If FAQ rich results stop appearing despite valid markup, this may indicate Google's algorithms have determined your site doesn't meet authority thresholds for FAQ display.

A Working FAQPage Example

The markup below is a complete, valid FAQPage block for two visible questions. Place it in the page head or body, keep the answer text identical to what site visitors can read, and never inject questions that do not appear on the rendered page. Answers accept a small amount of HTML (links, lists, paragraphs), which Google strips back to plain text for display.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How long does shipping take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Standard orders ship in 2 to 3 business days."
      }
    },
    {
      "@type": "Question",
      "name": "Do you offer refunds?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes, within 30 days of purchase for unused items."
      }
    }
  ]
}
</script>

Common validation failures come from a mismatch between markup and visible text, missing acceptedAnswer objects, answers that contain disallowed elements, and nesting FAQPage inside an Article graph. Keep FAQPage as its own top level type so parsers read it cleanly.

Deciding Which Pages Deserve FAQ Markup

Not every page benefits. Because rich result eligibility narrowed to authoritative government and health domains, the practical value on a commercial site now comes from three places: cleaner extraction into AI Overviews and answer engines, better voice assistant read outs, and a tidy internal signal that your page directly answers common questions. Prioritise pages where genuine questions cluster and where a concise answer resolves intent. For a deeper primer on when markup still earns its keep, see our companion note on whether FAQ schema is still worth it.

Page TypeAdd FAQPage?Why
Service and product pagesYes, if questions are realResolves buyer intent and feeds answer engines
Support and policy pagesYesRefund, shipping, and warranty questions extract cleanly
Blog and guide postsSelectivelyOnly where a compact Q&A adds value beyond the prose
Community threadsNo, use QAPageUser generated answers require the QAPage type
Landing pages with no real FAQsNoFabricated questions risk a manual action

Validation and Testing Workflow

Treat validation as a repeatable step rather than a one time check. Run each template through the Rich Results Test at search.google.com/test/rich-results to confirm the FAQPage parses and the questions are detected. Use the Schema Markup Validator at validator.schema.org for strict syntax checking that is not tied to Google eligibility. After deployment, watch the FAQ report inside Search Console under Experience and Enhancements for valid, warning, and error states, and set a monthly cadence to catch template regressions. When you optimise the same answers for AI answer engines, pair this markup with the practices in our answer engine optimization guide and structure the visible copy for citation as described in the AI Overviews optimization guide.

Frequently Asked Questions

Does FAQ schema still generate rich results in 2026?

Rarely for commercial sites. Google restricted FAQ rich results to well known authoritative government and health sites for relevant queries. Other sites can still add valid markup, but visible rich results are not guaranteed, so the practical payoff is cleaner extraction for AI answers and voice.

What is the difference between FAQPage and QAPage?

FAQPage is for author written questions and answers published by the site owner. QAPage is for pages where users submit and vote on answers, such as forums and community threads. Using FAQPage for user generated content is a guideline violation.

Do the answers need to be visible on the page?

Yes. Google requires that the full question and answer text is present and visible to users on the page. Hidden, tabbed away, or markup only answers that do not appear in the rendered content can trigger a structured data manual action.

How long should FAQ answers be?

Keep answers concise but complete, typically one to three sentences. Overly long answers may be truncated and add little value for extraction. Focus each answer on directly resolving the question rather than upselling.

Can I put FAQPage schema inside my Article schema?

Keep FAQPage as its own top level type rather than nesting it inside Article or Product. A flat graph is easier for parsers to read and less likely to produce validation warnings, though multiple types can coexist in one graph array.

Which tools validate FAQ markup?

Use Google's Rich Results Test to check eligibility and detection, and the Schema Markup Validator for strict syntax. After launch, monitor the FAQ enhancement report in Search Console for valid, warning, and error counts across your templates.

Claude Vincent is a technical SEO consultant focused on crawlability, rendering, and AI-search visibility. He writes the field guides and case studies at SEO ProCheck, with a bias toward the durable, unglamorous work that decides whether search engines and AI answer engines can actually read and cite a site.

About SEO ProCheck

Technical SEO consulting and GEO strategy with 20 years of enterprise experience. Case studies, resources, and tools for search and AI visibility.

Work With Me

Technical SEO audits, GEO strategy, site migrations, and international SEO. Hourly consulting for teams who need hands-on support, not just reports.

Subscribe to our newsletter!

More from our blog