Skip to main content
SlapMyWeb
Schema Markup9 min read

FAQ Schema: How to Get FAQ Rich Snippets in Google

FAQ schema explained for 2026: copy-paste JSON-LD, the rich-snippet rules that changed, validation steps, and how it wins AI citations.

SlapMyWeb Team·
FAQ Schema: How to Get FAQ Rich Snippets in Google

FAQ schema is structured data (JSON-LD) that labels a block of questions and answers on your page so search engines and AI assistants can understand it as a Q&A set. You add it with a small <script type="application/ld+json"> tag built on the FAQPage type from schema.org. The honest 2026 reality: Google has restricted the visual FAQ rich snippet in regular search results to well-known, authoritative government and health sites — but valid FAQ schema still earns you machine-readable structure that powers AI Overviews, ChatGPT, Perplexity, and Gemini citations, voice answers, and cleaner indexing. So you add it for the answer layer, not for the accordion that mostly disappeared.

Most people get this wrong because they read a 2021 tutorial promising expandable boxes for everyone. That changed. This guide gives you the real rules, copy-paste code that validates, and the workflow that actually moves the needle today.

What FAQ Schema Actually Is

FAQ schema marks up a list of questions your organization asks and answers on a page. It uses the FAQPage type, which contains a mainEntity array of Question entities, each holding one acceptedAnswer of type Answer. The whole thing lives in a single JSON-LD script tag that search engines parse separately from your visible HTML.

The structural hierarchy is simple:

  • FAQPage — one wrapper per page

- Question — each FAQ item (the name is the question text) - Answer — the acceptedAnswer with a text field holding the answer

Because the markup sits in its own <script> block, you can add or edit it without touching your layout, CSS, or design. That separation is exactly why Google recommends JSON-LD over inline Microdata or RDFa — it is clean, easy to template, and easy to validate.

One critical distinction: FAQ schema is for content where you supply both the question and the answer. If users ask and other users answer (a forum, a community thread), that is QAPage schema — a completely different type. Mixing them up makes Google ignore your markup.

Why It Still Matters in 2026 (The Honest Version)

Let me be direct about what changed, because most articles on this topic are stale. In mid-2023 Google announced that FAQ rich results would only show for well-known, authoritative government and health websites. For everyone else, the expandable accordion in the blue-link results largely went away.

So why bother? Because the snippet was never the only payoff. Here is what valid FAQ schema still does:

  • Feeds AI answer engines. Google's AI Overviews, ChatGPT, Perplexity, and Gemini parse structured data to understand and quote pages. A clean question-answer pair is exactly the format these systems extract and cite. This is the single biggest reason to keep using it.
  • Powers voice and assistant answers. Assistant-style results often read a concise acceptedAnswer aloud.
  • Improves entity and topic understanding. Explicit Q&A structure helps search engines map what your page covers.
  • Future-proofs your markup. If Google expands FAQ display again, or a vertical you operate in qualifies, the schema is already there.

What it does not do: directly raise your ranking position. Schema is a presentation and parsing signal, not a ranking factor. Anyone promising a ranking boost from FAQ schema alone is selling you something. If you want to confirm whether your pages even have valid markup, run a free SlapMyWeb audit to see which of these issues your site actually has.

Marketer reviewing FAQ schema documentation on a laptop at a tidy desk
Marketer reviewing FAQ schema documentation on a laptop at a tidy desk

How FAQ Schema Connects to the Rest of Your SEO

FAQ schema is one item in a larger structured-data and answer-engine strategy. It rarely works in isolation:

If you also care about…Pair FAQ schema with
Broader structured dataschema markup for beginners
Getting quoted by AI assistantsAI Overviews and how to get featured
Optimizing for answer engines generallyAEO vs SEO guide
Clean on-page structureheading tags H1–H6 that rank
Whole-site technical healththe complete technical SEO guide

The strongest FAQ pages combine the schema with genuinely useful answers, a logical heading structure, and a page that already earns trust. Schema amplifies a good page; it cannot rescue a thin one.

1. Write the FAQ Content First

Before any code, your questions and answers must exist as visible text on the page. Google requires that FAQ schema mirror visible on-page content. Schema-only FAQs — answers that live in the JSON-LD but appear nowhere on screen — are a guideline violation that can trigger a manual action.

Write 4–8 questions your audience genuinely asks. Mine real demand instead of inventing filler:

  • Check the People Also Ask box for your target query
  • Pull real questions from Search Console query data
  • Read support tickets, sales call notes, and on-site search logs

Keep each answer to 2–4 sentences: direct, specific, and quotable. Lead with the answer in the first sentence, then add the detail — this is the exact format AI engines extract. Do not stuff keywords; FAQ content that reads like keyword soup gets flagged.

2. Build the JSON-LD Markup

You can hand-write JSON-LD, but a generator is faster and avoids syntax slips. Here is a complete, valid FAQPage block you can adapt directly:

json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is FAQ schema markup?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "FAQ schema markup is structured data in JSON-LD format that tells search engines a page contains a set of questions and answers. Search engines and AI assistants use it to understand, quote, and present that Q&A content."
      }
    },
    {
      "@type": "Question",
      "name": "How many FAQs should a page include?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Aim for four to eight focused, high-quality questions per page. Cramming twenty or more generic questions onto one page signals low-quality content and provides no extra benefit."
      }
    },
    {
      "@type": "Question",
      "name": "Does FAQ schema improve rankings?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "No. FAQ schema is a parsing and presentation signal, not a ranking factor. It helps search engines and AI systems understand and cite your content, which is a separate benefit from ranking position."
      }
    }
  ]
}

Notice the answer text contains no HTML, no smart quotes, and no line breaks that could break the JSON. Keep answers as plain strings. If you must include a link inside an answer, schema.org permits a limited set of HTML tags (<a>, <p>, <br>, lists) — but plain text is safest.

The HTML you actually paste

Wrap the JSON in a script tag. It works in the <head> or right before </body>; Google processes both identically.

html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Your question here?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Your answer here."
      }
    }
  ]
}
</script>

WordPress: paste into a Custom HTML block, or use your SEO plugin's schema/FAQ block (Yoast, Rank Math, and others ship FAQPage blocks that generate this for you). Next.js / React: render it server-side in your page component — a dedicated <JsonLd> component using dangerouslySetInnerHTML with JSON.stringify is the cleanest pattern, and it guarantees the markup is in the initial HTML rather than injected after hydration.

3. Validate Before You Ship

A single missing comma silently kills the entire block — Google does not partially parse broken JSON. Validate every time:

  1. [Schema.org validator](https://validator.schema.org/) — confirms your structure matches the vocabulary.
  2. Google Rich Results Test — paste the live URL (or code) to confirm Google can read the FAQPage and see whether it is eligible for any enhancement.

Validation catches syntax errors (unescaped quotes, trailing commas, unclosed brackets) and structural issues (wrong type names, missing acceptedAnswer) before they reach production.

Hands typing JSON-LD code in a code editor on a desktop monitor
Hands typing JSON-LD code in a code editor on a desktop monitor

4. Deploy, Recrawl, and Monitor

After publishing, request indexing in Google Search Console to speed up the recrawl (typically a few days). Then watch two places:

  • Search Console → Enhancements → FAQ (when present) shows whether Google detected valid FAQ items and lists any errors.
  • Search Console → Performance → Search Appearance reveals whether any FAQ enhancement is being served for your qualifying pages.

Remember the 2023 restriction: if you are not a recognized government or health authority, do not expect the visual accordion. Judge success instead by clean validation, error-free Enhancement reports, and — over time — appearances or citations in AI Overviews and assistant answers.

Common Mistakes That Break FAQ Schema

Invalid JSON syntax

The number-one failure. A missing comma, an extra bracket, or an unescaped quote inside answer text breaks the whole FAQPage. Always run it through a validator. Copy-paste from a word processor (which inserts curly quotes) is the usual culprit.

Content not visible on the page

Every question and answer in the schema must appear in the rendered page. JavaScript-driven accordions are fine because Google renders JS — but content that exists only in the JSON-LD is a violation that can cost you all enhancements site-wide.

Schema/visible-text mismatch

The answer text in your markup should match the on-page answer. Heavily paraphrased or different content between the two is treated as misleading markup.

Too many or off-topic FAQs

Twenty-plus questions on one page signals low quality. Keep it to a focused 4–8 that genuinely relate to the page topic. And do not bolt FAQ schema onto pages with no real Q&A just to "have schema."

Using FAQPage for user-generated Q&A

If your community asks and answers, that is QAPage, not FAQPage. Using the wrong type makes Google discard the markup.

A Reusable Workflow for Many Pages

For a site with dozens of FAQ pages, manual JSON editing does not scale. Build a template instead:

  1. Audit — find every page that has Q&A content but no schema. A complete SEO audit surfaces these quickly.
  2. Template — store questions and answers as structured CMS fields, then render the FAQPage JSON-LD automatically from those fields.
  3. Validate in CI — lint the generated JSON on build so a broken page never ships.
  4. Monitor — track Enhancement reports and AI citations over time.

This way every new FAQ page gets correct, validated markup with zero hand-editing — and you stay aligned with the broader schema markup fundamentals.

Two colleagues reviewing a Search Console enhancements report on a large monitor
Two colleagues reviewing a Search Console enhancements report on a large monitor

Frequently Asked Questions

Does FAQ schema still get rich snippets in Google?

For most sites, no. Since 2023 Google shows the visual FAQ rich result only for well-known, authoritative government and health websites. Other sites still benefit from valid FAQ schema through AI Overviews, assistant answers, and better content parsing, but should not expect the expandable accordion in normal search results.

Is FAQ schema a Google ranking factor?

No. FAQ schema is a structured-data signal that helps search engines and AI systems understand and present your content; it does not directly raise your ranking position. Any ranking benefit is indirect, coming from clearer content understanding and improved presentation rather than the markup itself.

Will FAQ schema help me get cited by ChatGPT, Perplexity, or AI Overviews?

Yes, this is now its strongest use. AI answer engines parse structured data to identify clean question-answer pairs, which makes your content easier to extract and quote. Pairing concise, answer-first FAQ content with valid FAQPage markup increases your chance of being cited in AI-generated answers.

Can I use FAQ schema with other schema types on the same page?

Yes. A page can carry Product, BreadcrumbList, and FAQPage schema at once, and Google processes each type independently. Place each type in its own <script type="application/ld+json"> tag, or combine them in a single valid JSON array.

How long until FAQ schema is detected after I add it?

Detection usually happens within a few days to two weeks after Google recrawls the page, and you can speed it up by requesting indexing in Search Console. If the Enhancement report still shows nothing after two to three weeks, recheck your validation and confirm the FAQ content is visible on the page.

Free tool
Schema Markup Generator
Generate JSON-LD structured data for 15+ schema types with a visual form builder. Free, no signup, runs in your browser.

SlapMyWeb Team

We build SlapMyWeb — a brutally honest AI website audit that scans 240+ SEO, performance and Core Web Vitals signals and hands you the fix code.

Ready to test your site?

Get a free AI audit in 30 seconds. No signup required.

Slap My Website