How to Add FAQ Schema: A Step-by-Step Guide (with Examples)
FAQPage schema is the most-quoted markup in AI answers. Here's exactly how to add it — with copy-paste JSON-LD and the mistakes to avoid.
Why FAQPage schema is worth it
FAQPage markup explicitly maps questions to answers — exactly the structure AI engines lift into responses and the format Google uses for rich results. It's high-impact and quick to add.
Add the JSON-LD
Place this in your page <head>, with the questions and answers matching your visible content:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [{
"@type": "Question",
"name": "What is llms.txt?",
"acceptedAnswer": { "@type": "Answer",
"text": "A markdown file at your domain root that summarizes your site for AI." }
}]
}
</script>Avoid the common mistakes
The schema answers must match what's visible on the page, every Question needs exactly one acceptedAnswer, and you should validate with Google's Rich Results Test before shipping.
FAQ schema: do vs don't
| Do | Don't |
|---|---|
| Match schema to visible Q&A | Mark up hidden or fake questions |
| One acceptedAnswer per Question | Multiple or missing answers |
| Validate before publishing | Ship unvalidated JSON-LD |
| Keep answers concise & factual | Stuff keywords into answers |
Frequently asked questions
How do I add FAQ schema?⌄
Add a FAQPage JSON-LD script to your page head with Question/acceptedAnswer pairs that match your visible FAQ, then validate with Google's Rich Results Test.
Does FAQ schema help with AI?⌄
Yes — FAQPage is one of the most-quoted schema types in AI answers because it maps questions directly to answers.
Can I fake questions in FAQ schema?⌄
No. The schema must match visible content; mismatched or hidden Q&A can be ignored or penalized. Mark up only real, visible FAQs.
