Skip to content
Free Indian Tools

SEO

FAQ blocks vs FAQ schema — what is the difference and do you need both

FAQ block is the visible HTML on the page. FAQ schema is the JSON-LD that helps search engines parse it. You need both — and they must match for rich results.

2 April 2026 · 2 min read


Quick frame: A FAQ block is the visible HTML on the page (typically <details><summary> elements). FAQ schema is the JSON-LD that helps Google parse the same content for rich results and AI Overview citations. You need both, and Google requires them to match exactly.

Two layers, one source of truth

The visible HTML

Modern accessible default is <details> / <summary>:

<section class="faq">
  <details>
    <summary>Question 1?</summary>
    <p>Answer 1.</p>
  </details>
  <details>
    <summary>Question 2?</summary>
    <p>Answer 2.</p>
  </details>
</section>

Works without JavaScript. Screen readers handle it correctly. No ARIA roles needed.

The JSON-LD schema

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Question 1?",
      "acceptedAnswer": { "@type": "Answer", "text": "Answer 1." }
    }
  ]
}

Place in the page head or before closing body.

The matching requirement

Google's structured data guideline: visible content must match the schema. Hidden / schema-only FAQs lose rich result eligibility entirely.

This means: if the visible FAQ section shows 5 questions, the schema must declare exactly 5 questions, with identical text.

The easiest way to keep them in sync is to generate both from the same source. Our FAQ block HTML generator emits matching HTML and JSON-LD together — no drift possible.

Why both surfaces matter

The HTML serves users

The visible FAQ section answers questions for users browsing the page. Click-through rates from the SERP are higher when users can see relevant questions in the result snippet.

The schema serves search

Google parses the schema to:

  • Qualify the page for FAQ rich results (limited eligibility since 2023).
  • Cite the page as an AI Overview source.
  • Surface the questions as PAA (People Also Ask) candidates.
  • Help Bing render FAQ rich results (still broadly eligible on Bing).

When to skip schema

You can skip the schema (and just have visible HTML) when:

  • The FAQs are user-submitted (UGC) — schema rich results don't apply.
  • The FAQs are promotional rather than user-question-driven.
  • You're on a domain Google has restricted from FAQ rich results.

Even in these cases, the schema costs nothing to emit and may regain eligibility.

Quality bar for both

  • 3–8 questions per page (fewer = thin; more = diluted).
  • Real user questions, not promotional FAQs.
  • Answers under 1000 characters (Google truncates longer).
  • No links inside answer text (Google ignores them).

The wider FAQ schema discussion is in FAQ schema when to actually use.

FAQ

Q. Can the visible FAQ be collapsed by default? A. Yes — <details> defaults to closed. Google still indexes the content inside.

Q. Should the FAQ section be near the top or bottom of the page? A. User-question pages: near the top. Editorial articles: at the bottom. Match the reader's sequence.

Q. Can I have multiple FAQ schema blocks on one page? A. Yes — but they should still match the visible content collectively. Usually cleaner to combine into a single block.

Try the free tool

FAQ Block HTML Generator

Semantic FAQ HTML + matching JSON-LD schema together — both ready.

Open FAQ Block HTML Generator

Related guides