FAQ (FAQPage, Question, Answer) structured data

FAQ rich result in Google Search

If your government-focused or health-focused site has a list of questions and answers, you can use FAQPage structured data to help people find that information on Google. Properly marked up FAQ pages may be eligible to have a rich result on Search and an Action on the Google Assistant, which can help your site reach the right users.

Feature availability

FAQ rich results are only available for well-known, authoritative websites that are government-focused or health-focused. The feature is available on desktop and mobile devices in all countries and languages where Google Search is available.

How to add structured data

Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.

Here's an overview of how to build, test, and release structured data.

  1. Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
  2. Follow the guidelines.
  3. Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
  4. Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is accessible to Google and not blocked by a robots.txt file, the noindex tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs.
  5. To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.

Examples

JSON-LD

Here's an example of FAQPage in JSON-LD:


<html>
  <head>
    <title>Finding an apprenticeship - Frequently Asked Questions(FAQ)</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "FAQPage",
      "mainEntity": [{
        "@type": "Question",
        "name": "How to find an apprenticeship?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "<p>We provide an official service to search through available apprenticeships. To get started, create an account here, specify the desired region, and your preferences. You will be able to search through all officially registered open apprenticeships.</p>"
        }
      }, {
        "@type": "Question",
        "name": "Whom to contact?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "You can contact the apprenticeship office through our official phone hotline above, or with the web-form below. We generally respond to written requests within 7-10 days."
        }
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdata

Here's an example of FAQPage in Microdata:


<html itemscope itemtype="https://schema.org/FAQPage">
<head></head>
<body>
  <h1>
    Frequently Asked Questions(FAQ)
  </h1>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">How to find an apprenticeship?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <div itemprop="text">
        We provide an official service to search through available apprenticeships. To get started, create an account here, specify the desired region, and your preferences. You will be able to search through all officially registered open apprenticeships.
      </div>
    </div>
  </div>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">Whom to contact?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <div itemprop="text">
        You can contact the apprenticeship office through our official phone hotline above, or with the web-form below. We generally respond to written requests within 7-10 days.
      </div>
    </div>
  </div>
</body>
</html>

Guidelines

For your FAQ page to be eligible for FAQ rich results, you must follow these guidelines:

Content guidelines

  • Your site must be a health or government site. It must also be well-known and authoritative.
  • Only use FAQPage if your page contains FAQs where there's a single answer to each question. If your page has a single question and users can submit alternative answers, use QAPage instead. Here are some examples:

    Valid use cases:

    • An FAQ page written by the health site itself, with no way for users to submit alternative answers
    • A government agency's support page that lists FAQs, with no way for users to submit alternative answers

    Invalid use cases:

    • A forum page where users can submit answers to a single question
    • A product support page where users can submit answers to a single question
    • A product page where users can submit multiple questions and answers on a single page
  • Don't use FAQPage for advertising purposes.
  • Make sure each Question includes the entire text of the question and make sure each Answer includes the entire text of the answer. The entire question text and answer text may be displayed.
  • Question and answer content may not be displayed as a rich result if it contains any of the following types of content: obscene, profane, sexually explicit, graphically violent, promotion of dangerous or illegal activities, or hateful or harassing language.
  • All FAQ content must be visible to the user on the source page. Here are some examples:

    Valid use cases:

    • Both the question and answer are visible on the page.
    • The question is visible on the page, and the answer is hidden behind an expandable section. The user is able to access the answer by clicking the expandable section.

    Invalid use cases: The user can't find the FAQ content on the page at all.

  • If you have FAQ content that is repetitive on your site (meaning, the same question and answer appear on multiple pages on your site), mark up only one instance of that FAQ for your entire site.

Structured data type definitions

You must include the required properties for your content to be eligible for display as a rich result. You can also include the recommended properties to add more information to your structured data, which could provide a better user experience.

FAQPage

The full definition of FAQPage is provided on schema.org.

The FAQPage type indicates that the page is an FAQ with answered questions. There must be one FAQPage type definition per page.

The Google-supported properties are the following:

Required properties
mainEntity