FAQPage JSON-LD Template

What this describes

Use FAQPage when a page contains questions and answers supplied by the publisher and visitors cannot submit competing answers. Use QAPage for a page centered on one question with user-submitted answers. Choose the type because it accurately describes the page, not to create a FAQ section for a hoped-for search display.

Copyable template

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "@id": "https://www.example.com/help/example-topic/#faq",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is the first visible question?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The complete answer shown on the page."
      }
    },
    {
      "@type": "Question",
      "name": "What is the second visible question?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The complete second answer shown on the page."
      }
    }
  ]
}

Customize it

• Keep each Question.name aligned with the visible question.
• Put the substantive visible answer in acceptedAnswer.text; do not add hidden promotional claims.
• Include only questions that belong to the same FAQ page.
• Update or remove markup when the visible answer changes or disappears.
• Do not use FAQPage for forums, product reviews, or pages where users contribute alternative answers.

Validate it

Use the live-page JSON-LD validation tutorial and test it with Schema.org Validator. Compare every question and answer with the rendered page. Do not use rich-result appearance as the success criterion for this template; check a current consumer’s documentation only when that feature is part of the implementation goal.

Official reference

• Schema.org: FAQPage