Skip to content
Made For Builders iconoMade For Builders

DefinedTerm · Glossary

What is FAQPage Schema

FAQPage schema is a Schema.org structured data type that lets webmasters mark up a list of questions and their answers directly on a web page. Google can use this markup to display expandable question-and-answer pairs beneath the page title in search results, increasing visual prominence without requiring a position change. In the era of generative search, FAQPage markup also signals to AI systems which questions a page authoritatively answers.

edu-lopez-paradaPublicado Actualizado

Full definition

FAQPage is a Schema.org type that describes a page whose primary purpose is presenting one or more questions alongside their complete answers. It is always combined with the Question type: the FAQPage entity holds a mainEntity property that accepts an array of Question objects. Each Question has a name property (the question text) and an acceptedAnswer property pointing to an Answer object, which in turn carries a text property containing the full answer.

Google supports FAQPage markup as an eligible structured data type and can render a dedicated rich result format: individual questions appear as collapsible rows beneath the page listing in the SERP, letting users read answers without clicking through. The full answer text in the text property may include a limited set of HTML tags (<a>, <br>, <li>, <ol>, <ul>); plain text is always safe and preferred for maximum compatibility.

The questions and answers marked up must be visible on the page in a form accessible to users. Google's guidelines prohibit using FAQPage markup for content that is not genuinely present in the rendered page, or for content that is promotional rather than informational.

Why it matters in 2026

Google AI Overviews build answers from multiple sources. A page with well-structured FAQPage markup makes it unambiguous which questions the page addresses and exactly what the page's answer is. This reduces interpretive friction for the AI system and increases the probability of the page being cited as a source in a generative answer.

On the conventional SERP, the FAQ rich result format expands the physical footprint of the listing. A result that would normally occupy two lines of text can occupy six to ten lines when FAQ rows are expanded, pushing competing listings further down without any improvement in ranking. This is a meaningful advantage for informational queries in competitive niches such as home services.

How to implement

  1. Write a genuine FAQ section on the page. Each question must have a complete, self-contained answer that appears in the visible HTML—do not markup questions whose answers are hidden behind tabs or accordions that require JavaScript and are not in the DOM on load.
  2. For each question-answer pair, ensure both the question text and the full answer text are present in the HTML source or server-rendered output.
  3. Add a <script type="application/ld+json"> block to the page with @type set to "FAQPage".
  4. Populate mainEntity with an array of Question objects. Each object needs @type: "Question", a name (question text), and an acceptedAnswer object with @type: "Answer" and a text property.
  5. Validate the markup with Google's Rich Results Test. The test will confirm whether the page is eligible for the FAQ rich result and flag any missing or invalid properties.
  6. Monitor the "FAQ" enhancement report in Google Search Console after deployment to detect crawl-time errors or policy violations that would suppress the rich result.

Example

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How much does a new HVAC system cost in the US?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The cost of a new HVAC system in the United States typically ranges from $5,000 to $12,500 for a central air and heating unit, including equipment and installation. The final price depends on the home's square footage, the efficiency rating of the unit, and regional labor rates."
      }
    },
    {
      "@type": "Question",
      "name": "How long does HVAC installation take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "A standard HVAC replacement on an existing system takes between four and eight hours. New installations requiring ductwork can take one to three days depending on the size and layout of the property."
      }
    }
  ]
}

Related terms

Schema markup, HowTo schema, DefinedTerm schema.

Fuentes

Términos relacionados

  • schema-markup
  • howto-schema
  • definedterm-schema