FAQPage schema: complete guide

When to use: Pages with a clear FAQ section and matching Q&A content.

Required properties

mainEntity — Array of Question items with acceptedAnswer

Optional properties

speakable — Optional speakable selectors if used

Example JSON-LD

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is JSON-LD?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "JSON-LD is a format for linked data using JSON, often embedded in script tags."
      }
    }
  ]
}

Validation tips

Questions and answers must be visible on the page verbatim
Do not use FAQPage for advertising-only content
One FAQPage per page with a real FAQ UI

Overview

FAQPage can earn FAQ rich results when content quality and policy requirements are met. Every Question in JSON-LD should appear on the page for users.

If FAQs are thin or duplicated site-wide, skip markup until content is unique and helpful.

Try the free Schema Generator →