AEOTools

FAQ Schema Example: FAQPage JSON-LD for Visible Q&A

Updated July 11, 2026 by vito.wu

FAQPage schema describes visible question-and-answer content that a business, publisher, or product team answers directly. Use the examples below as a starting point, then replace every detail with content users can read on your own published page.

Generate FAQPage JSON-LD from your own Q&A

Add the questions and answers already shown on your page, preview the JSON-LD, and copy the markup without writing it by hand.

Open FAQ Schema Generator

When Does FAQPage Schema Fit?

Use FAQPage schema for a page with a visible, editorially controlled Q&A section. Typical examples include product support articles, pricing pages, service pages, onboarding documentation, and help center pages where the site owner provides the answer.

FAQPage is not a substitute for useful page content, and it is not the right type for forums or community questions with multiple user-contributed answers. In that situation, use QAPage markup instead.

Valid markup also does not promise a visual treatment in search. Google currently limits FAQ rich result display mainly to well-known government and health websites. For a commercial site, focus on accurate, readable Q&A rather than adding FAQPage only to chase a rich result. Read Google's FAQ rich result update for the current eligibility policy.

SaaS Pricing FAQ Schema Example

Use FAQPage markup for an authoritative Q&A section on a pricing or product page. The answer in JSON-LD must be the same answer visitors can read.

Visible Q&A on the page

Can I change plans later?

Yes. You can upgrade or downgrade your plan from billing settings. Changes take effect at the start of your next billing cycle unless you choose an immediate upgrade.

Is there a free trial?

Yes. Every paid plan includes a 14-day free trial. You can cancel before the trial ends and will not be charged.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Can I change plans later?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes. You can upgrade or downgrade your plan from billing settings. Changes take effect at the start of your next billing cycle unless you choose an immediate upgrade."
      }
    },
    {
      "@type": "Question",
      "name": "Is there a free trial?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes. Every paid plan includes a 14-day free trial. You can cancel before the trial ends and will not be charged."
      }
    }
  ]
}

Product Support FAQ Schema Example

Use this pattern for a help center article that answers recurring product questions. Keep the FAQ short and place each answer in the visible support content.

Visible Q&A on the page

How do I reset my account password?

Select Forgot password on the sign-in page, enter the email address associated with your account, and use the reset link sent to your inbox.

Where can I see my billing invoices?

Open Settings, choose Billing, and select Invoices. You can download each completed invoice as a PDF.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How do I reset my account password?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Select Forgot password on the sign-in page, enter the email address associated with your account, and use the reset link sent to your inbox."
      }
    },
    {
      "@type": "Question",
      "name": "Where can I see my billing invoices?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Open Settings, choose Billing, and select Invoices. You can download each completed invoice as a PDF."
      }
    }
  ]
}

Service Page FAQ Schema Example

Use FAQPage markup on a service page when the business itself provides the definitive answers. Do not use it to mark up questions answered by a community of users.

Visible Q&A on the page

What is included in a technical SEO audit?

A technical SEO audit reviews crawlability, indexation, page performance, internal linking, structured data, and the main issues that affect search visibility.

How long does a technical SEO audit take?

Most audits take one to two weeks, depending on the site size, technical complexity, and access needed for analytics and Search Console data.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is included in a technical SEO audit?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "A technical SEO audit reviews crawlability, indexation, page performance, internal linking, structured data, and the main issues that affect search visibility."
      }
    },
    {
      "@type": "Question",
      "name": "How long does a technical SEO audit take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Most audits take one to two weeks, depending on the site size, technical complexity, and access needed for analytics and Search Console data."
      }
    }
  ]
}

FAQ Schema Rules and Validation

  1. Show every marked-up question and answer to visitors on the same page. JSON-LD is not a place for hidden sales copy or content from another URL.
  2. Use FAQPage when the page owner supplies one authoritative answer to each question. Use QAPage for pages where users submit questions and multiple answers.
  3. Write concise, complete answers. Replace every example name, policy, price, time frame, and URL with information that is true for the published page.
  4. Keep FAQPage markup focused on genuine, recurring questions. A long list of loosely related keyword questions makes the page less useful and harder to maintain.
  5. Validate the final rendered page after deployment, not only the code in your editor.
  6. Test the published URL in Google's Rich Results Test and use URL Inspection to confirm Google can crawl the final page. Google's structured data guidelines also require markup to be a truthful representation of page content.

Related Schema Guides

FAQ Schema Example FAQ

What is FAQPage schema?

FAQPage schema is JSON-LD structured data for a page that contains a list of questions with one authoritative answer to each question. The questions and answers must also be visible to visitors on that page.

Does FAQ schema guarantee a Google rich result?

No. Google does not guarantee any rich result for valid structured data. Google also limits FAQ rich result display primarily to well-known government and health websites, so most commercial sites should use FAQPage markup for accurate page understanding rather than expect an expanded FAQ result.

Should FAQ schema match visible content?

Yes. The marked-up question and answer should match the visible Q&A on the same page. Do not add answers that visitors cannot read or that describe another page.

When should I use QAPage instead of FAQPage?

Use QAPage when users can submit questions and answers, such as a forum or community site. Use FAQPage when the page owner provides the single official answer to each question.

Where do I add FAQPage JSON-LD?

Add the JSON-LD in a script tag with type application/ld+json on the same URL that displays the FAQ content. It can be placed in the page head or body when it remains available to Googlebot.

Need FAQPage markup for a real page?

Add the visible questions and answers from your page, then copy JSON-LD that matches the published content.

Generate FAQ Schema