What is FAQPage schema

Full definition

FAQPage is a schema.org type that describes a page whose primary content is a set of questions paired with their answers. It is used together with the Question type to mark up each individual question-and-answer pair. The central property is mainEntity, which accepts an array of Question objects. Each Question requires two properties: name (the question text) and acceptedAnswer (an Answer object containing a text property with the full answer).

Google defines specific eligibility rules for this rich result. The questions and answers must appear visibly on the page — the markup cannot describe content that is absent from the HTML. Each answer must be the definitive answer to that question as provided by the site: user-generated answer threads with multiple competing responses use a different type (QAPage) rather than FAQPage. All answers must be factually present in the rendered page content, not only in the script block.

The markup itself lives in a <script type="application/ld+json"> block and is invisible to users. Google's crawler reads it separately from the visible HTML, so formatting decisions for the visible FAQ section (accordions, plain lists, tabs) do not affect eligibility — provided the question and answer text is present in the DOM.

Why it matters in 2026

Google AI Overviews extract discrete passages to build direct answers. A FAQPage-marked block structures your content into self-contained, labelled question-answer units that are far easier for a retrieval system to identify and attribute than equivalent prose embedded in body copy. The page is not just answering a question — it is declaring that this specific text is the answer to this specific question, with the full authority of the schema.org contract behind it.

As a rich result, the FAQ expansion can double or triple the vertical space your listing occupies on a search results page, increasing click-through rate from the same organic position. For trades and home-services businesses — where users frequently search with question-intent queries such as "how long does a boiler installation take" — FAQPage markup aligns directly with the query format Google sees most often.

How to implement

1. Write a FAQ section on the page with real questions your customers ask and complete, factual answers. Truncated answers or teaser text are not eligible.
2. Ensure both the question text and the full answer text are present in the visible HTML — not hidden behind JavaScript that only renders on interaction.
3. Add a <script type="application/ld+json"> block to the page with a root object of type FAQPage.
4. Set the mainEntity property to an array of Question objects, one per question.
5. For each Question, set name to the full question string and acceptedAnswer to an Answer object with the text property containing the complete answer. Basic HTML in the answer text (bold, lists) is permitted.
6. Validate the markup using Google's Rich Results Test to confirm eligibility and check for missing required properties.
7. After publishing, monitor the FAQ enhancement in Google Search Console under Enhancements to track impressions and catch errors introduced by future content updates.

Example

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How long does a boiler installation take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "A standard boiler replacement in a UK home typically takes between four and eight hours for a Gas Safe registered engineer. Replacing a like-for-like combi boiler in an accessible location is usually completed in a single working day. More complex installations involving flue repositioning or pipework changes may require a second day."
      }
    },
    {
      "@type": "Question",
      "name": "What is the average cost of a new boiler in the UK?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The cost of a new boiler in the UK typically ranges from £1,500 to £3,500 fully installed, depending on the boiler type, brand, output rating and the complexity of the installation. A combi boiler replacement in an existing combi location sits at the lower end of that range. System boiler conversions or heat-only replacements with hot-water cylinders increase the total."
      }
    }
  ]
}

Related terms

Schema markup, HowTo schema, DefinedTerm schema.