Mark Up FAQs with Structured Data

A Frequently Asked Question (FAQ) page contains a list of questions and answers pertaining to
a particular topic. 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. Here’s an example of an FAQ rich result:

Image of an FAQ rich Search result

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. For a step-by-step guide
on how to add structured data to a web page, check out the
structured
data codelab.

  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.
  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.

Feature availability

FAQ rich results are available in all countries and languages where Google Search
is available. The feature is available on desktop and mobile devices.

Examples

JSON-LD

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

<html>
  <head>
    <title>Example Site - Frequently Asked Questions(FAQ)</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "FAQPage",
      "mainEntity": [{
        "@type": "Question",
        "name": "What is the return policy?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "<p>Most unopened items in new condition and returned within <strong>90 days</strong> will receive a refund or exchange. Some items have a modified return policy noted on the receipt or packing slip. Items that are opened or damaged or do not have a receipt may be denied a refund or exchange. Items purchased online or in-store may be returned to any store.</p><p>Online purchases may be returned via a major parcel carrier. <a href=http://example.com/returns> Click here </a> to initiate a return.</p>"
        }
      }, {
        "@type": "Question",
        "name": "How long does it take to process a refund?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "We will reimburse you for returned items in the same way you paid for them. For example, any amounts deducted from a gift card will be credited back to a gift card. For returns by mail, once we receive your return, we will process it within 4–5 business days. It may take up to 7 days after we process the return to reflect in your account, depending on your financial institution's processing time."
        }
      }, {
        "@type": "Question",
        "name": "What is the policy for late/non-delivery of items ordered online?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "<p>Our local teams work diligently to make sure that your order arrives on time, within our normaldelivery hours of 9AM to 8PM in the recipient's time zone. During  busy holiday periods like Christmas, Valentine's and Mother's Day, we may extend our delivery hours before 9AM and after 8PM to ensure that all gifts are delivered on time. If for any reason your gift does not arrive on time, our dedicated Customer Service agents will do everything they can to help successfully resolve your issue.</p><p><a href=https://example.com/orders/>Click here</a> to complete the form with your order-related question(s).</p>"
        }
      }, {
        "@type": "Question",
        "name": "When will my credit card be charged?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "We'll attempt to securely charge your credit card at the point of purchase online. If there's a problem, you'll be notified on the spot and prompted to use another card. Once we receive verification of sufficient funds, your payment will be completed and transferred securely to us. Your account will be charged in 24 to 48 hours."
        }
      }, {
        "@type": "Question",
        "name": "Will I be charged sales tax for online orders?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text":"Local and State sales tax will be collected if your recipient's mailing address is in: <ul><li>Arizona</li><li>California</li><li>Colorado</li></ul>"}
        }]
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdata

Here’s an example of FAQPage in Microdata:

<html itemscope itemtype="https://schema.org/FAQPage">
<head>
  <title>Example Site - Frequently Asked Questions(FAQ)</title>
    </head>
<body>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h3 itemprop="name">What is the return policy?</h3>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <div itemprop="text">
        Most unopened items in new condition and returned within <strong>90 days</strong> will receive a refund or exchange. Some items have a modified return policy noted on the receipt or packing slip. Items that are opened or damaged or do not have a receipt may be denied a refund or exchange. Items purchased online or in-store may be returned to any store.
        <br /><p>Online purchases may be returned via a major parcel carrier. <a href="http://example.com/returns"> Click here </a> to initiate a return.</p>
      </div>
    </div>
  </div>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h3 itemprop="name">How long does it take to process a refund?</h3>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <div itemprop="text">
        We will reimburse you for returned items in the same way you paid for them. For example, any amounts deducted from a gift card will be credited back to a gift card. For returns by mail, once we receive your return, we will process it within 4–5 business days. It may take up to 7 days after we process the return to reflect in your account, depending on your financial institution's processing time.
    </div>
  </div>
</div>
<div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
  <h3 itemprop="name">What is the policy for late/non-delivery of items ordered online?</h3>
  <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
    <div itemprop="text">
      Our local teams work diligently to make sure that your order arrives on time, within our normal delivery hours of 9AM to 8PM in the recipient's time zone. During  busy holiday periods like Christmas, Valentine's and Mother's Day, we may extend our delivery hours before 9AM and after 8PM to ensure that all gifts are delivered on time. If for any reason your gift does not arrive on time, our dedicated Customer Service agents will do everything they can to help successfully resolve your issue.
      <br/> <p><a href="https://example.com/orders/">Click here</a> to complete the form with your order-related question(s).</p>
    </div>
  </div>
</div>
<div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
  <h3 itemprop="name">When will my credit card be charged?</h3>
  <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
    <div itemprop="text">
      We'll attempt to securely charge your credit card at the point of purchase online. If there's a problem, you'll be notified on the spot and prompted to use another card. Once we receive verification of sufficient funds, your payment will be completed and transferred securely to us. Your account will be charged in 24 to 48 hours.
    </div>
  </div>
</div>
<div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
  <h3 itemprop="name">Will I be charged sales tax for online orders?</h3>
  <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
    <div itemprop="text">
      Local and State sales tax will be collected if your recipient's mailing address is in:
      <ul>
        <li>Arizona</li>
        <li>California</li>
        <li>Colorado</li>
      </ul>
    </div>
  </div>
</div>
  </body>
</html>

Guidelines

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

Content guidelines

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.

Required properties
mainEntity Question

An array of Question elements which comprise the list of answered questions
that this FAQPage is about.

Question

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

The Question type defines a single answered question within the FAQ. Every
Question instance must be contained within the mainEntity property array
of the schema.org/FAQPage.

Required properties
acceptedAnswer Answer

The answer to the question. There must be one answer per question.

name Text

The full text of the question. For example, “How long does it take to process a refund?”.

Answer

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

The Answer type defines the acceptedAnswer to each of the
Question on this page.

Required properties
text Text

The full answer to the question. The answer may contain HTML content such as links and
lists. Google Search displays the following HTML tags; all other tags are ignored:
<h1> through <h6>,
<br>, <ol>,
<ul>, <li>,
<a>, <p>,
<div>, <b>,
<strong>, <i>,
and <em>.

Monitor rich results with Search Console

Search Console is a tool that helps you monitor how your pages perform in Google Search.
You don’t have to sign up for Search Console to be included in Google Search results,
but it can help you understand and improve how Google sees your site. We
recommend checking Search Console in the following cases:

  1. After deploying structured data for the first time
  2. After releasing new templates or updating your code
  3. Analyzing traffic periodically

After deploying structured data for the first time

After Google has indexed your pages, look for issues using the relevant
Rich result status report.
Ideally, there will be an increase of valid pages, and no increase in errors or warnings. If you find issues
in your structured data:

  1. Fix the errors.
  2. Inspect a live URL to check if the issue persists.
  3. Request validation using the status report.

After releasing new templates or updating your code

When you make significant changes to your website, monitor for increases in structured data errors and warnings.

  • If you see an increase in errors, perhaps you rolled out a new template that doesn’t work, or your site interacts with the existing
    template in a new and bad way.
  • If you see a decrease in valid items (not matched by an increase in errors), perhaps you are
    no longer embedding structured data in your pages. Use the
    URL Inspection tool to learn what is causing the issue.

Analyzing traffic periodically

Analyze your Google Search traffic using the Performance Report.
The data will show you how often your page appears as a rich result in Search, how often users click on it and what is
the average position you appear on search results. You can also automatically pull these
results with the Search
Console API.

Troubleshooting

If you’re having trouble implementing or debugging structured data, here are some resources that
may help you.

Related Articles

Leave a Reply

Back to top button