FAQPage

FAQPage marks a page as containing a list of frequently asked questions with answers. Google uses FAQPage markup to display expandable question-and-answer pairs directly in search results, giving pages significantly more visual real estate. AI answer engines pull directly from FAQPage structured data when responding to questions that match the marked-up Q&A pairs.

Google requires that every question and answer in the FAQPage markup is visible on the page. Hidden content, accordion items that require JavaScript to reveal, or answers that only exist in the markup will cause the page to fail validation.

Fields by Google status

Required

• mainEntity — An array of Question objects. Each Question contains an acceptedAnswer with an Answer object holding the response text.

JSON-LD example

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is structured data?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Structured data is a standardized format for providing information about a page and classifying the page content. Search engines use it to understand page content and display rich results."
      }
    },
    {
      "@type": "Question",
      "name": "Does structured data affect rankings?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Structured data does not directly boost rankings. It enables rich results that can increase click-through rates, which may indirectly improve performance."
      }
    },
    {
      "@type": "Question",
      "name": "How many questions can FAQPage contain?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "There is no hard limit, but Google typically displays up to 10 questions in FAQ rich results. Including more than 10 is valid markup but the additional questions will not appear in the rich snippet."
      }
    }
  ]
}

When to use FAQPage

Use FAQPage on any page whose primary purpose is answering common questions: dedicated FAQ pages, support pages, and product pages with a Q&A section. The page must display all questions and answers in its visible content.

Do not use FAQPage for:

• Pages where only one question is answered (use QAPage instead for single-question formats)
• Forums or user-generated Q&A (use QAPage with community answers)
• Pages where the FAQ section is a minor addition rather than the page's purpose

FAQPage markup can coexist with other types on the same page. A product page can include both Product and FAQPage markup if it has a visible FAQ section.

Related types

• QAPage — for single-question pages with one or more answers
• WebPage — parent type; FAQPage is a subtype of WebPage
• HowTo — for step-by-step instructions rather than Q&A format