FAQPage

The FAQPage type represents a page that contains a list of frequently asked questions and their answers. When implemented correctly, search engines can display individual questions and answers directly in search results as expandable rich results. This increases your page’s visibility and can significantly improve click-through rates by answering user queries before they even visit your site.

When to Use This

Use FAQPage when a page’s primary content is a list of questions and answers authored by the site owner. The questions must be visible on the page — you cannot use FAQPage markup for content that is not displayed to users.

Good candidates for FAQPage markup:

• Dedicated FAQ pages for a product, service, or organization
• Support pages that answer common customer questions
• Pages that address frequently searched questions about a topic

Do not use FAQPage if:

• The questions are submitted by users and answered by other users — use QAPage instead
• There is only one question on the page — technically valid, but multiple questions better match intent
• The page is primarily an article or guide with a small FAQ section — use Article and consider adding FAQPage only if the FAQ section is substantial
• The answers are generated automatically without editorial oversight

Google’s guidelines require that FAQPage content is visible on the page and not misleading. Pages that use FAQ markup purely for SEO manipulation — such as stuffing promotional content into answers — may have their rich results revoked.

Required Properties

Each Question object requires:

Each Answer object requires:

Recommended Properties

For individual questions, you may also include:

JSON-LD Example

A complete FAQPage markup with three questions:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "name": "Online Orders — Frequently Asked Questions",
  "description": "Common questions about ordering, shipping, returns, and payment for our online store.",
  "dateModified": "2026-02-28T10:00:00-05:00",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How long does shipping take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Standard shipping takes 5-7 business days within the continental United States. Expedited shipping (2-3 business days) is available for an additional $12.99. Orders placed before 2:00 PM EST on business days ship the same day. Alaska and Hawaii orders may take an additional 3-5 business days."
      }
    },
    {
      "@type": "Question",
      "name": "What is your return policy?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "We accept returns within 30 days of delivery for a full refund. Items must be unused and in their original packaging. To initiate a return, log into your account, go to <a href=\"https://example.com/orders\">Order History</a>, and select \"Request Return\" next to the item. We provide a prepaid return shipping label for domestic orders. Refunds are processed within 5-7 business days after we receive the returned item."
      }
    },
    {
      "@type": "Question",
      "name": "Do you ship internationally?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes, we ship to over 40 countries. International shipping rates are calculated at checkout based on the destination and package weight. Delivery times vary by country but typically range from 10-21 business days. Please note that customers are responsible for any customs duties, taxes, or import fees charged by their country. We currently do not ship to P.O. boxes for international orders."
      }
    }
  ]
}

The same FAQPage marked up with Microdata:

<div itemscope itemtype="https://schema.org/FAQPage">
  <h1>Online Orders — Frequently Asked Questions</h1>

  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">How long does shipping take?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <p itemprop="text">
        Standard shipping takes 5-7 business days within the continental United States.
        Expedited shipping (2-3 business days) is available for an additional $12.99.
        Orders placed before 2:00 PM EST on business days ship the same day.
        Alaska and Hawaii orders may take an additional 3-5 business days.
      </p>
    </div>
  </div>

  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">What is your return policy?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <p itemprop="text">
        We accept returns within 30 days of delivery for a full refund.
        Items must be unused and in their original packaging.
        To initiate a return, log into your account, go to Order History,
        and select "Request Return" next to the item.
      </p>
    </div>
  </div>

  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">Do you ship internationally?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <p itemprop="text">
        Yes, we ship to over 40 countries. International shipping rates are
        calculated at checkout based on the destination and package weight.
        Delivery times vary by country but typically range from 10-21 business days.
      </p>
    </div>
  </div>
</div>

The same FAQPage marked up with RDFa:

<div vocab="https://schema.org/" typeof="FAQPage">
  <h1>Online Orders — Frequently Asked Questions</h1>

  <div property="mainEntity" typeof="Question">
    <h2 property="name">How long does shipping take?</h2>
    <div property="acceptedAnswer" typeof="Answer">
      <p property="text">
        Standard shipping takes 5-7 business days within the continental United States.
        Expedited shipping (2-3 business days) is available for an additional $12.99.
        Orders placed before 2:00 PM EST on business days ship the same day.
        Alaska and Hawaii orders may take an additional 3-5 business days.
      </p>
    </div>
  </div>

  <div property="mainEntity" typeof="Question">
    <h2 property="name">What is your return policy?</h2>
    <div property="acceptedAnswer" typeof="Answer">
      <p property="text">
        We accept returns within 30 days of delivery for a full refund.
        Items must be unused and in their original packaging.
        To initiate a return, log into your account, go to Order History,
        and select "Request Return" next to the item.
      </p>
    </div>
  </div>

  <div property="mainEntity" typeof="Question">
    <h2 property="name">Do you ship internationally?</h2>
    <div property="acceptedAnswer" typeof="Answer">
      <p property="text">
        Yes, we ship to over 40 countries. International shipping rates are
        calculated at checkout based on the destination and package weight.
        Delivery times vary by country but typically range from 10-21 business days.
      </p>
    </div>
  </div>
</div>

Common Mistakes

• Marking up content not visible on the page. Every question and answer in your FAQPage markup must appear as visible text on the page. Hidden content or markup-only FAQ entries violate Google’s guidelines.
• Using FAQPage for user-generated Q&A. If users submit questions and the community answers them, use QAPage instead. FAQPage is specifically for content authored by the site owner.
• Putting promotional content in answers. Answers should directly address the question. Stuffing answers with sales copy, discount codes, or unrelated promotional material can result in a manual action.
• Exceeding practical limits. While there is no hard limit on the number of questions, Google typically displays 2-4 FAQ results in search. Including dozens of trivial questions dilutes quality. Focus on the most important and commonly asked questions.
• HTML in text that is not properly escaped. When including HTML in the text field (for links or formatting), ensure it is valid HTML. Broken tags or unclosed elements can cause parsing failures.
• Forgetting the Answer wrapper. The acceptedAnswer must contain an Answer object with a text property. Placing the answer text directly in acceptedAnswer without the proper type is invalid.
• Duplicate questions across pages. Do not mark up the same FAQ on multiple pages. Each FAQ entry should appear on one canonical page only.
• Not updating dateModified. When FAQ answers change (e.g., updated policies, new pricing), update the dateModified timestamp. Stale dates on changed content can be flagged.

Testing & Validation

1. Google Rich Results Test — Paste your FAQ page URL at search.google.com/test/rich-results. Verify that the FAQ result type appears and each question is detected without errors.
2. Schema.org Validator — Use validator.schema.org to check that your JSON-LD structure is valid and all required properties are present.
3. Google Search Console — After indexing, check the “FAQs” section under Enhancements. This shows which pages have valid FAQ markup and which have errors.
4. Visual cross-check — Compare every question and answer in your markup against the visible page content. They must match. Even small wording differences (like a shortened answer in the markup) can be problematic.
5. Mobile rendering — FAQ rich results are particularly prominent on mobile search. Test your page on a mobile device to see how expanded FAQ results appear and ensure the on-page FAQ content is easily navigable on small screens.

Related Schemas

• WebPage — The generic page type that FAQPage extends.
• HowTo — For step-by-step instructional content, which sometimes overlaps with FAQ intent.
• Article — For editorial content that may include a supplementary FAQ section.