Free tool · no sign-up

FAQ schema generator

Turn your FAQs into valid FAQPage structured data. Machine-readable Q&A helps search engines and AI assistants understand, and quote, your answers.

JSON-LD output ·

            

Paste this into the <head> or body of the page that shows these FAQs, then validate with Google’s Rich Results Test.

In short

FAQ schema is structured data (JSON-LD) that marks up questions and answers on a page using the schema.org FAQPage type. It helps search engines and AI answer engines understand your Q&A content. Add your questions here, copy the generated code and place it on the same page that shows those FAQs.

Built and maintained by MSJ Info Support, a digital marketing and AI search company in Surrey, British Columbia.

How to use this tool

  1. 1Add your questionsUse the real questions customers ask, ideally the ones shown on the page.
  2. 2Copy the JSON-LDThe code updates live as you type.
  3. 3Add it to your pagePaste into the page HTML and validate with Google’s Rich Results Test.

Getting FAQ schema right

FAQ schema is easy to generate and easy to get wrong in a way that quietly breaks it. There are three things worth understanding before you paste the code.

The rule that catches most people

Every question and answer in your markup must be visible on the page, in the same words. Schema that describes content a visitor cannot see breaks Google guidelines, and the markup is ignored at best.

This rules out the common shortcut of generating a dozen keyword-shaped questions and dropping the JSON-LD on a page that shows none of them. If you want the schema, write the FAQ section and publish it.

It also means you cannot mark up questions that are answered in a dropdown loaded later by JavaScript, unless the content is in the HTML to begin with.

What changed with FAQ rich results

Google narrowed FAQ rich results in 2023 so that the expandable questions under a listing now show mainly for well-known government and health sites. For most businesses, adding FAQ schema will not produce that visual treatment any more.

Plenty of guides still promise those rich results. They are out of date, and it is worth knowing before you judge whether the markup worked.

Why it is still worth adding

The rich result was never the only reason to do this. Structured Q&A is the format AI answer engines handle best: an explicit question paired with a self-contained answer is exactly what a model needs to quote you accurately.

It also forces a useful discipline. Writing answers that stand alone, without "as mentioned above", produces content that works in a featured snippet, a voice result and an AI summary — none of which carry the surrounding page with them.

Writing questions worth marking up

Use the questions customers actually ask, in their words. The ones from sales calls and WhatsApp threads outperform the ones invented for a keyword tool, because they match how people phrase things when they search.

  • Answer in the first sentence. Context after, never before.
  • Keep each answer self-contained. Assume it will be read with nothing around it.
  • Two to four sentences. Long enough to be complete, short enough to quote.
  • Include the awkward ones. Price, timelines and what you do not do build more trust than another benefit.

Three to ten genuinely useful questions beats twenty padded ones.

Where the code goes, and how to check it

Paste the JSON-LD anywhere in the page HTML — the head or just before the closing body tag are both fine. In WordPress, use your SEO plugin or a header and footer code plugin rather than editing the theme, so an update cannot wipe it.

Then run the URL through Google’s Rich Results Test and the Schema.org validator. The first tells you whether Google can read it, the second whether it is technically valid. Both are free and take a minute.

Does FAQ schema still help SEO?

Google now shows FAQ rich results mainly for authoritative government and health sites, but FAQ schema still helps search engines and AI assistants understand your content, which supports AI answers.

Can I add FAQ schema for questions not on the page?

No. Google requires that every question and answer marked up as FAQ schema is visible to a visitor on the same page. Marking up questions that are not there breaks the structured data guidelines, and the usual outcome is that Google ignores the entire FAQ block rather than the offending part of it.

Where do I put the code?

Anywhere in the page’s HTML, commonly in the head or just before the closing body tag. In WordPress, use your SEO plugin or a header/footer code plugin.

How many questions should I add?

Include the questions people genuinely ask, which for most pages means somewhere between three and ten. There is no bonus for volume. A long list of thin questions dilutes the page, while a handful answered properly is what gets quoted, so write each answer to make sense read on its own.

Will FAQ schema give me the expandable questions in Google?

Usually not any more. Google narrowed that rich result in 2023 to mainly government and health sites. The markup still helps search engines and AI assistants understand and quote your answers, which is now the main reason to add it.

Can I use FAQ schema on every page?

You can, but only where a real FAQ section exists on that page and genuinely helps the reader. Adding a token FAQ block to every page to carry markup is the kind of pattern that ages badly.