FAQ Structured Data: Complete Implementation Guide

Why Use FAQPage Schema?

• Expands your search result listing with collapsible Q&A pairs, increasing your visual presence on the search results page and pushing competitors further down.
• Improves click-through rates by giving users immediate, useful answers while encouraging them to visit your page for more detailed information.
• Relatively straightforward to implement compared to other structured data types, making it an excellent starting point for sites new to schema markup.
• Can be applied to a wide variety of page types including product pages, service pages, blog posts, and dedicated FAQ sections.
• Enhances voice search compatibility, as search engines may use FAQ structured data to source answers for voice assistant responses.

Required Properties

These properties are required by Google for FAQPage structured data to be eligible for rich results.

Recommended Properties

Adding these properties improves your chances of appearing in rich results and provides more context to search engines.

JSON-LD Example

Here is a complete FAQPage structured data example you can use as a starting point. Or use our FAQPage generator to create one automatically.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is structured data and why does it matter for SEO?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Structured data is a standardised format for providing information about a page and classifying its content. It uses vocabulary from <a href=\"https://schema.org\">Schema.org</a> to help search engines understand your pages more effectively. For SEO, structured data can trigger rich results — enhanced search listings that include star ratings, images, FAQs, and other visual elements — which typically achieve higher click-through rates than standard blue link results."
      }
    },
    {
      "@type": "Question",
      "name": "How do I add FAQ structured data to my website?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The recommended approach is to add a JSON-LD script block to your HTML page. Place a &lt;script type=\"application/ld+json\"&gt; tag in the &lt;head&gt; or &lt;body&gt; of your page containing a FAQPage object with your questions and answers structured as an array within the mainEntity property. Each question should be a Question object with a name (the question) and acceptedAnswer (an Answer object with the answer text)."
      }
    },
    {
      "@type": "Question",
      "name": "Can I use FAQ structured data on any page?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "FAQ structured data should only be used on pages where the primary content includes a list of questions and answers that the page author has written. It should not be used on forum pages where users submit questions, nor on pages with a single question — use QAPage markup for those instead. The questions and answers must be visible on the page."
      }
    },
    {
      "@type": "Question",
      "name": "Is there a limit to how many FAQs I can mark up?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "There is no hard limit set by Google on the number of FAQ items you can include. However, Google typically displays a maximum of two to four questions in the rich result, with a 'Show more' link for additional entries. Include all genuine FAQs on the page, but prioritise quality over quantity."
      }
    },
    {
      "@type": "Question",
      "name": "Do FAQ rich results still appear in Google Search?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "As of 2023, Google reduced the frequency of FAQ rich results, limiting them primarily to well-known, authoritative government and health websites. However, implementing the markup remains worthwhile as Google may expand eligibility in the future, and the structured data still helps search engines understand your content."
      }
    }
  ]
}
</script>

How to Implement FAQPage Schema

1. 1Audit your site for pages that contain genuine FAQ content — questions and answers written by the site owner or editorial team. Do not use FAQ markup for user-generated Q&A or forum content.
2. 2Ensure all FAQ content is visible on the page. Google requires that every question and answer in the structured data is also present in the on-page content. Hidden or accordion-style content is acceptable as long as it is in the HTML source.
3. 3Create a JSON-LD script block and set the @type to 'FAQPage'. Add each question-and-answer pair as a Question object within the mainEntity array.
4. 4For each Question, set 'name' to the question text and nest an Answer object within 'acceptedAnswer' containing the answer in the 'text' property. You may include basic HTML in the answer text for formatting and links.
5. 5Place the JSON-LD script in the <head> or <body> of your HTML. If your site uses a CMS, consider using a plugin or template modification to generate FAQ markup dynamically from your content.
6. 6Validate the markup using Google's Rich Results Test, then monitor performance in Google Search Console under the FAQ enhancements report to track impressions and identify any issues.

Common Mistakes to Avoid

• Using FAQPage markup for content that is not genuinely in a question-and-answer format, or fabricating questions solely to gain rich results rather than addressing real user queries.
• Including questions and answers in the structured data that are not visible on the page. Google requires a one-to-one match between markup and on-page content.
• Confusing FAQPage with QAPage — FAQPage is for author-written FAQ content, while QAPage is for pages where users submit questions and other users provide answers (e.g., Stack Overflow-style forums).
• Using FAQ markup on every page of the site, including pages where FAQ content is not the primary focus. Overuse can dilute the signal and may be flagged as spammy by search engines.
• Forgetting to include HTML formatting in the Answer.text property when answers contain links, lists, or emphasis. Plain text answers miss the opportunity to include clickable links in the rich result.

Testing & Validation

Before deploying your FAQPage structured data, validate it using these tools:

1. 1Google Rich Results Test — Paste your page URL or code snippet to check if your structured data is eligible for rich results.
2. 2Schema Markup Validator — Validates your JSON-LD syntax against the schema.org specification.
3. 3Google Search Console — After deployment, monitor the Enhancements report for any errors or warnings.

Frequently Asked Questions