# FAQ schema: how to mark up your FAQ section

> Your page has an FAQ but no FAQPage markup. Learn what FAQ schema does today, why AI search engines still use it, and how to add it correctly.

Source: https://thatonecrawler.houseofnamus.com/checks/faq-schema · Updated 2026-10-22 · By Suman Debnath (https://sumandebnath.houseofnamus.com)

FAQ schema, or FAQPage structured data, marks each question and answer in your FAQ section so machines don't have to guess. Google now shows FAQ rich results for very few sites, but the markup still helps search engines and AI answer engines match your answers to the questions people ask.

## Why it matters

An FAQ section is one of the easiest ways to be quoted by AI tools, because it pairs real questions with direct answers. Without markup, that structure is only implied by formatting; with it, it's explicit.

## How to fix it

1. Make sure the FAQ answers questions readers really ask, in two to four sentences each.
2. Generate FAQPage JSON-LD; our AI FAQ tool builds it from your page.
3. Paste it into the page head or use your SEO plugin's FAQ block.
4. Mark up only questions and answers that are visible on the page.
5. Validate with Google's Rich Results Test.

## Frequently asked questions

### Does Google still show FAQ rich results?

Since 2023, mostly for authoritative government and health sites. The markup is still valid and still useful for machine understanding.

### Can I mark up questions that aren't on the page?

No. Structured data must describe visible content, otherwise it can be treated as spam.

## Related checks

- [Structured data for blogs: missing, broken and incomplete markup](https://thatonecrawler.houseofnamus.com/checks/structured-data)
- [AI search readiness: how to get your blog cited by AI (GEO and AEO)](https://thatonecrawler.houseofnamus.com/checks/ai-search-readiness)

---

That One Crawler: Free SEO audit tool for blogs. Crawl your whole site to find broken links, thin content, duplicate titles, keyword cannibalization and AI search gaps. Run a free audit at https://thatonecrawler.houseofnamus.com. All pages: https://thatonecrawler.houseofnamus.com/llms.txt
