What Is FAQ Schema? A Simple Guide With Examples (2026)
FAQ schema is a small piece of code you add to a page that tells Google, “this page has questions and answers.” When Google understands it, your page can show those questions and answers right in the search results, which makes your listing taller and easier to notice. If you already know the basics from our beginner’s guide to schema markup, this guide goes one step further and covers one specific type: FAQ schema.
What Is FAQ Schema, in Plain English?
FAQ schema is structured data that uses the FAQPage type from Schema.org. You write your questions and answers in a format called JSON-LD, which is a script block added to your page. People visiting your site never see the code. Search engines read it and use it to understand the Q&A content on the page.
Here is the key point: the questions and answers in your code must also appear on the page where visitors can read them. Google does not want hidden content. If your page shows a visible FAQ section, FAQ schema simply labels that same content for search engines.
What Does FAQ Schema Look Like in Search Results?
When FAQ schema works, a search result can show two or three questions under the page title, each with a short answer that expands when clicked. This is called a FAQ rich result. It gives your listing more space on the page and can lift the number of people who click through, because searchers can see that your page answers their exact question.
One honest warning: Google has tightened FAQ rich results over the past few years. Today, these expanded listings show most often for well-known, authoritative sites, such as government and health pages. Smaller sites may not see the expanded listing even with perfect code. That does not make FAQ schema useless, though. Clean question-and-answer content is also easier for AI answers and voice assistants to pull from, and it still helps search engines understand your page.
How FAQ Schema Is Built
FAQ schema has three layers:
- FAQPage — the whole page, or the FAQ section of the page.
- Question — each question, written in the “name” field.
- Answer — the answer to that question, written in the “acceptedAnswer” field.
Here is a short example you can learn from. Do not copy it word for word onto your site — change the questions and answers to match your own page:
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is FAQ schema?",
"acceptedAnswer": {
"@type": "Answer",
"text": "FAQ schema is structured data that labels questions and answers on a page so search engines can show them as rich results."
}
}
]
}
Keep each answer short and complete on its own, ideally two or three sentences. An answer that only makes sense after reading the rest of the page is a weak answer.
How to Add FAQ Schema to Your Site
Option 1: Use a plugin FAQ block (easiest)
If you run WordPress, the simplest path is an FAQ block. Rank Math and Yoast both offer FAQ blocks in the block editor. You type your questions and answers into the block, and the plugin writes the FAQ schema for you. This is the safest option for beginners because the code stays in step with the visible content.
Option 2: Add the JSON-LD code by hand
If your site does not use WordPress, or you want full control, paste a JSON-LD script into the page. You can write it yourself following the example above, or use a free FAQ schema generator to build the code and then paste it in. Either way, the script must sit on the same page as the visible FAQ section.
Option 3: Add it through Google Tag Manager
Some site owners add JSON-LD through a Tag Manager tag. This works, but it is the least reliable of the three options, because the code loads after the page itself. If you can add the code to the page directly, do that instead.
Rules Google Expects You to Follow
- Visible content only. Every question and answer in your code must appear on the page for visitors too.
- Real questions only. The questions should be ones people actually ask, not lines you wrote to stuff keywords in.
- No advertising. Do not mark up sales pitches, coupon lists, or promotional claims as FAQs.
- No duplicate FAQs. Do not put the same FAQ section on every page of your site. Each page should have its own questions.
- One FAQ section per page is enough. Adding three FAQ blocks to one page does not triple your chances.
Breaking these rules can cost you the rich result, and in serious cases Google can remove rich results from your whole site. It is not worth cutting corners here.
How to Check That Your FAQ Schema Works
After you add the code, test the page with Google’s Rich Results Test. Paste your page URL and run the test. It will tell you whether the FAQ markup is valid and flag any errors, such as a missing answer field. Fix errors before you move on.
Then check Google Search Console. The enhancements section reports FAQ pages it has found and any problems with them. Check back a week or two after publishing, because Google needs time to re-crawl the page. If the test passes but no rich result appears, that is normal — Google decides case by case whether to show one.
Common FAQ Schema Mistakes
- Marking up content visitors cannot see. This is the most common mistake, and the one Google cares about most.
- Answers that are too long. A 300-word answer will not display well. Keep it tight.
- Copying the same FAQ onto every page. It looks like spam to a search engine, because it is.
- Using FAQ schema on a page with no FAQ section. If there are no visible questions, there is nothing to mark up.
- Expecting instant results. Even valid markup takes time to be picked up, and a rich result is never guaranteed.
Should You Bother With FAQ Schema in 2026?
Yes, with realistic expectations. The code itself takes minutes to add if you use a plugin block, and it costs nothing. It will not lift your rankings on its own — Google has said structured data is not a direct ranking factor. What it can do is make your listing more useful in search, help AI tools and voice assistants reuse your answers, and force you to write clearer questions and answers, which helps readers too. That is a good return for a few minutes of work.
Frequently Asked Questions About FAQ Schema
Does FAQ schema improve Google rankings?
Not directly. It can improve click-through rate by making your listing bigger and more helpful, and better clicks over time can support your traffic, but the code itself is not a ranking boost.
Can any website use FAQ schema?
Yes. Any site can add valid FAQPage markup. Whether Google shows the expanded rich result depends on the site and the query, and authoritative sites see it most often.
How many questions should a FAQ section have?
Five to ten genuine questions is a good range for most pages. Fewer is fine if that is all the page needs. More than ten usually means the page is trying to cover too much.
Do I need a plugin to add FAQ schema?
No, but a plugin FAQ block is the easiest and safest way on WordPress. Hand-written JSON-LD works just as well if you test it and keep it matched to the visible content.
What happens if my FAQ schema has an error?
Google simply will not show a rich result for that page until the error is fixed. Run the Rich Results Test, fix what it flags, and ask Google to re-crawl the page.
Last updated: October 2026