How to add FAQ schema markup — with copy-paste examples
Updated June 5, 2026 · 5 min read
FAQ schema tells AI engines — ChatGPT, Perplexity, Gemini, and Google AI Overviews — that your page directly answers specific questions, and hands them a clean question-and-answer pair they can quote. It's the highest-leverage structured-data fix for most sites, and it takes under an hour to add.
What FAQPage schema actually does
FAQPage is a Schema.org type that wraps one or more Question-and-Answer pairs in machine-readable JSON. When an AI engine crawls your page, this markup tells it: 'this page contains authoritative answers to these specific questions, and here they are, verbatim.' The engine can then pull that text into an answer without having to parse your prose.
That's why it maps so directly onto AI search: users prompt engines with questions, and FAQ schema pre-packages your answers in the exact format the engine needs. In our 2026 study of 30 leading brands, only 5% used FAQPage markup — which means adding it puts you ahead of 95% of your competitors for this signal.
The JSON-LD template (copy-paste ready)
Paste a script tag with type="application/ld+json" in the <head> of any page you want to mark up. The structure below is the complete, valid template — replace the placeholder questions and answers with your own:
- { "@context": "https://schema.org", "@type": "FAQPage",
- "mainEntity": [
- { "@type": "Question", "name": "What does your product do?",
- "acceptedAnswer": { "@type": "Answer", "text": "Your concise answer here." } },
- { "@type": "Question", "name": "How much does it cost?",
- "acceptedAnswer": { "@type": "Answer", "text": "Pricing starts at $X/month." } }
- ] }
Where to place the script tag
Put the JSON-LD block inside a <script type="application/ld+json"> tag in the <head> section of your HTML. Most CMS platforms and frameworks make this straightforward — in WordPress, plugins like Yoast SEO or Rank Math let you paste JSON-LD into a field. In Next.js, add a dangerouslySetInnerHTML script to your page component. In plain HTML, paste it directly.
One FAQPage block per page is the standard pattern. If you have multiple FAQ pages, each gets its own block — don't combine them into a single giant block spanning the whole site.
Which questions to include
- The questions your sales team answers on every demo call — these are what buyers actually ask.
- The questions in your live chat or support inbox — real language from real people.
- The top autocomplete suggestions when you type your product name or category into Google or Perplexity.
- Comparison questions ('X vs Y', 'how is X different from Z') — these match the most common AI prompt pattern for purchase decisions.
- Pricing and ROI questions — even if your pricing is custom, an honest 'it depends on...' answer is better than silence.
Common mistakes to avoid
- Generic questions no one asks — 'What is a FAQ?' wastes a slot and dilutes relevance.
- Answers that are vague or promotional rather than factual — AI engines prefer direct, quotable statements.
- Mismatched content — the Q&A in the schema should match what's actually on the page; don't mark up questions the page doesn't answer.
- Only marking up the homepage — add FAQ schema to every service, product, and blog page that answers specific questions.
- Forgetting to validate — use Google's Rich Results Test to confirm the markup parses correctly before deploying.
See where your site stands in AI search
Run a free AI Search Readiness audit and get your score plus the exact fixes.
Frequently asked questions
Does FAQ schema still work in 2026?
Yes — for AI search specifically, it's more valuable now than ever. Google's classic rich-result FAQ snippet has been scaled back, but the structured data itself is read by every major AI engine (ChatGPT, Perplexity, Gemini, Claude) and makes your page more quotable. The ROI has shifted from SERP real-estate to AI citation.
How many questions should I include per page?
Three to eight is a good practical range. Fewer than three is a missed opportunity; more than ten and the answers tend to get thin. Prioritize quality and real user questions over volume.
Can I add FAQ schema without a developer?
Yes. Yoast SEO (WordPress), Squarespace's schema settings, and Webflow's custom code fields all let non-developers paste JSON-LD. For any site, you can add it by pasting the script block into the page's HTML head — most site builders have a 'custom code' or 'head injection' field for exactly this.