How do I add FAQ schema to my website?

Why should you write your visible FAQ section before writing the schema?

Before adding schema, your page needs an actual FAQ section that human visitors can read. This is a critical rule: FAQ schema reflects existing on-page content. It does not create content.[2]

A minimal HTML FAQ section for a content page looks like this:

<section>
  <h2>Frequently Asked Questions</h2>

  <details>
    <summary>What is FAQ schema markup?</summary>
    <p>FAQ schema is structured data in JSON-LD format that tells AI engines and search systems the exact questions a page answers and what those answers are.</p>
  </details>

  <details>
    <summary>Where does FAQ schema go on a webpage?</summary>
    <p>FAQ schema goes in the head section of the HTML document, inside a script tag with type="application/ld+json".</p>
  </details>

</section>

The <details>/<summary> pattern is a clean accessible approach for FAQ accordions. Other HTML patterns work equally well. The structure of your visible FAQ doesn't constrain the schema.

How do you write the FAQ schema JSON-LD block?

With your visible FAQ in place, write the matching schema block. Here is a complete, working example with two questions that you can adapt directly:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is FAQ schema markup?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "FAQ schema is structured data in JSON-LD format that tells AI engines and search systems the exact questions a page answers and what those answers are. It sits in the page head, invisible to visitors but directly readable by machines."
      }
    },
    {
      "@type": "Question",
      "name": "Where does FAQ schema go on a webpage?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "FAQ schema goes in the head section of the HTML document, inside a script tag with type='application/ld+json'. This ensures AI crawlers read it before any JavaScript runs."
      }
    }
  ]
}
</script>

Key rules for the JSON:

• "name" contains the question text, written exactly as a visitor would ask it
• "text" contains the full answer. Complete sentences, not fragments
• All strings use double quotes. Single quotes or unquoted values will break JSON validity
• If your answer text contains double quotes, escape them with a backslash: \"

How do you combine FAQ schema with other schema types using @graph?

For content pages, FAQ schema is most powerful when stacked with other schema types. The @graph pattern lets you include multiple schema types in one script block:[3]

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "BlogPosting",
      "headline": "What is FAQ schema markup?",
      "description": "FAQ schema is structured data in JSON-LD...",
      "datePublished": "2026-03-18",
      "author": {
        "@type": "Person",
        "name": "Your Name",
        "url": "https://yoursite.com"
      }
    },
    {
      "@type": "FAQPage",
      "mainEntity": [
        {
          "@type": "Question",
          "name": "Your first question here?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "Your complete answer here."
          }
        }
      ]
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {"@type": "ListItem", "position": 1, "name": "Home", "item": "https://yoursite.com"},
        {"@type": "ListItem", "position": 2, "name": "Your Topic", "item": "https://yoursite.com/topic/"},
        {"@type": "ListItem", "position": 3, "name": "This Page", "item": "https://yoursite.com/topic/this-page"}
      ]
    }
  ]
}
</script>

This single block communicates: this is an article, written by this person, answering these specific questions, located at this position in the site structure. Four schema types. One script block. Maximum signal density.

Where exactly does the FAQ schema script go in your HTML file?

The entire <script type="application/ld+json"> block goes inside the <head> element of your HTML document. The conventional placement is after your meta tags and before the closing </head> tag:

<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Page Title | Site Name</title>
  <meta name="description" content="...">
  <link rel="canonical" href="...">

  <!-- Schema block goes here -->
  <script type="application/ld+json">
  { ... your schema ... }
  </script>

</head>

The most important rule: this block must be present in the static HTML source. Never inject schema markup via JavaScript. AI crawlers do not execute JavaScript, and dynamically injected schema is invisible to them.[4]

How do you validate your FAQ schema before publishing?

A single syntax error in your JSON breaks the entire schema block silently. AI crawlers and search engines simply skip it without warning. Always validate before publishing.

Two free validation tools:

• Google Rich Results Test. search.google.com/test/rich-results. Confirms whether Google can read your schema and whether it qualifies for rich results display. Paste your URL or raw HTML.
• Schema.org Validator. validator.schema.org. Validates your JSON-LD against the Schema.org specification. Useful for confirming the structure is correct even before a page is publicly live.

Common errors to check for: missing commas between objects, unclosed brackets, unescaped double quotes inside answer text, and missing required properties (@type, name, acceptedAnswer).