JSON-LD (JavaScript Object Notation for Linked Data) is a lightweight structured data format. It encodes data in JSON format with special @context and @type fields that tell machines what vocabulary the data uses.

What does @type: FAQPage mean?

@type: FAQPage is a schema.org type representing a FAQ page. It tells AI systems and parsers that the structured data on this page represents a set of questions and answers rather than other content types like articles or products.

Why use @context: https://schema.org?

The @context field tells parsers to interpret field names using schema.org vocabulary. This is the standard linked data vocabulary used by major search engines and AI systems to understand structured content.

What is the mainEntity field in FAQPage?

mainEntity is an array of Question entities — each representing one Q&A pair. Each Question has a name (the question text) and an acceptedAnswer (an Answer object with the answer text).

FAQ Schema JSON-LD Explained — What It Is and How It Works

What Is JSON-LD?

JSON-LD (JavaScript Object Notation for Linked Data) is a structured data format that makes content machine-readable. It uses standard JSON syntax with special fields (@context and @type) that tell parsers what vocabulary to use.

Unlike older formats like microdata, JSON-LD is placed in a <script> tag inside the <head> — it does not require any changes to your HTML structure or visible content.

FAQPage Schema Structure

A FAQPage JSON-LD has a simple three-layer structure:

{
  "@context": "https://schema.org",       ← tells parsers to use schema.org vocabulary
  "@type": "FAQPage",                    ← identifies this as FAQ content
  "mainEntity": [                        ← array of Question objects
    {
      "@type": "Question",
      "name": "Your question here?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Your answer here."
      }
    }
  ]
}

Required Fields

Field	Type	Required	Description
`@context`	String	Yes	Must be `https://schema.org`
`@type`	String	Yes	Must be `FAQPage`
`mainEntity`	Array	Yes	Array of Question objects (min 1)
`mainEntity[].@type`	String	Yes	Must be `Question`
`mainEntity[].name`	String	Yes	The question text
`mainEntity[].acceptedAnswer.@type`	String	Yes	Must be `Answer`
`mainEntity[].acceptedAnswer.text`	String	Yes	The answer text (recommended 40+ chars)

Mini JSON-LD Formatter & Copy Widget

Paste any JSON-LD below to format and validate it:

Why FAQPage JSON-LD Is Still Useful

Even though Google stopped showing FAQ rich results in 2026, FAQPage JSON-LD remains useful for:

AI system comprehension — AI models and tools can parse structured FAQ content more reliably than scraping raw HTML.
Content organization — Structured data forces you to write clear, well-defined Q&A content.
Internal tooling — Content management systems, chatbots, and internal search can use FAQPage schema to process Q&A content.
Documentation hygiene — Following structured data best practices keeps your technical SEO foundation solid.

FAQPage does not guarantee AI citations, ranking improvements, or featured snippets. It is one signal among many.

⚠️ FAQ Rich Results Are Not Guaranteed. Google stopped displaying FAQ rich results in 2026. Adding FAQPage JSON-LD helps AI readability and content organization — not Google search appearances.

Frequently Asked Questions

What is the difference between FAQPage and QAPage?

FAQPage is for pages where a website owner presents their own FAQ content. QAPage is for pages where community members submit questions and answers (like Stack Overflow). Most websites should use FAQPage.

Can I use HTML entities in FAQ answers?

Yes. JSON-LD supports standard HTML entities. However, avoid overusing special characters. Keep answers in plain, readable language without unnecessary HTML formatting.

What happens if my JSON-LD has a syntax error?

Invalid JSON will be ignored by parsers. Use the formatter widget above to validate your JSON-LD before adding it to your page. A missing comma or unquoted key will cause parsing to fail.

Is there a size limit for FAQPage JSON-LD?

There is no strict limit, but very large FAQPage schemas (hundreds of questions) may be ignored or truncated by some parsers. A typical FAQ section with 5–15 questions is well within acceptable range.