Insights

How to Add FAQ Schema Markup (With Examples)

5 Min Read

Updated August 2026

FAQ schema is a block of structured data (JSON-LD) that tells search engines and AI crawlers exactly which parts of your page are questions and which are answers, instead of making them guess from your HTML. It’s one of the highest leverage, lowest effort technical fixes for AEO.

What FAQ Schema Actually Does

Without schema, a search engine or AI crawler has to infer from your HTML that a particular heading is a question and the paragraph below it is the answer, and inference is unreliable. FAQ schema (formally FAQPage from schema.org) states it explicitly: this is a question, this is its accepted answer, full stop. That explicit structure is part of what determines whether a page gets pulled into an AI Overview or an answer engine’s citation. One thing to know up front: Google retired FAQ rich results in May 2026, per its own FAQPage documentation, so this markup no longer earns expandable dropdowns in Google results. Its value today is machine legibility: FAQPage remains a fully valid schema.org type that AI assistants and other answer engines read, and Google says existing markup causes no errors and no harm. See our full breakdown in what AEO actually is.

The Code: A Working Example

Here’s a minimal, valid FAQPage schema block for a page with two questions. Paste this inside a <script type="application/ld+json"> tag anywhere in your page’s HTML:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "What is FAQ schema?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "FAQ schema is structured data that explicitly marks question and answer content so search engines and AI crawlers can extract it accurately."
    }
  }]
}

Add one Question object per FAQ item inside the mainEntity array. The text field should match the visible answer on your page. Schema that doesn’t match visible content violates Google’s guidelines and can get the markup ignored.

Where to Add It on Your Page

The script tag can live anywhere in your page’s HTML, head or body, since it doesn’t render visually. The important part is that the questions and answers inside it should also exist as real, visible content on the page. Schema describes what’s there; it doesn’t substitute for it. See how this fits alongside other structured data types in Structured Data & Schema Markup: The Complete Guide.

Google’s Rules for FAQ Schema

Only mark up genuine FAQ content: question and answer pairs written by the page owner, not user generated Q&A (that’s a separate schema type). Don’t mark up the same content twice on one page, and don’t use it for advertising or unrelated links. Answers can include basic HTML like lists and links, but should stay concise and directly responsive to the question.

How to Validate It

Paste your raw JSON-LD into Schema.org’s validator before publishing. It will flag missing required fields or malformed JSON, and a single misplaced comma will silently break the entire block. Note that Google’s Rich Results Test dropped its FAQ check in June 2026, since the rich result is retired, so a clean validator pass plus a manual check that schema text matches your visible text is the complete workflow now.

This is exactly the markup we add to every page we build. See it live on our homepage FAQ or in our SEO vs AEO vs GEO article. If you’d rather have it done for you across your whole site, that’s part of our AEO services.

FAQ

Does FAQ schema still earn a rich result in Google?
No. Google retired FAQ rich results in May 2026, so the markup no longer produces expandable dropdowns in Google search results. It still improves how cleanly AI engines extract your Q&A content, and existing markup causes no errors, so it stays worth having.

Can I use FAQ schema on every page?
Only on pages that contain genuine, visible FAQ content. Adding it to pages without matching visible Q&A content violates guidelines and risks the markup being ignored or penalized.

What’s the difference between FAQPage and HowTo schema?
FAQPage is for question and answer pairs. HowTo schema is for step by step instructions with an ordered sequence. Use whichever matches your actual content structure.

Go deeper on AEO and structured data:

Want to Be the Brand AI Recommends?

Book a call and we’ll map what it takes to get there for your business.

Book a Call

Winsignia