Free FAQ Schema Generator (JSON-LD)
Add your questions and answers, and get valid FAQPage structured data in JSON-LD format, ready to paste into your page. A live preview shows how the FAQ will read.
JSON-LD output
This tool outputs JSON-LD only, the format Google recommends. No Microdata is needed, and you should not mark up the same FAQ twice in two formats.
Live preview
What is FAQ schema?
FAQ schema is structured data that uses the schema.org FAQPage type to label a list of questions and their answers on a page. It is written in JSON-LD, a small block of code inside a script tag that search engines and other machines read but visitors do not see. Each question becomes a Question item with an acceptedAnswer. Because the meaning of the content is spelled out explicitly, software does not have to guess which text is a question and which is the answer.
Does FAQ schema still produce rich results?
Expectations should be realistic. In August 2023 Google announced that FAQ rich results, the expandable questions shown under a search result, would only be shown for well-known, authoritative government and health websites. For most other sites, adding FAQPage markup will no longer produce that visual enhancement in Google Search. Google has said the markup does no harm when it is valid and matches the visible content.
So why use it? Structured data still makes the meaning of your content clearer. Other search engines, such as Bing, read schema.org markup, and AI-powered answer engines benefit from content that is well organised into direct question and answer pairs. The bigger win is usually the FAQ content itself: clear, concise answers to real customer questions are exactly the type of passage that search features and AI assistants tend to quote. Treat the markup as a tidy label on good content, not as a ranking trick.
How to add FAQ schema in WordPress
- Custom HTML block: in the block editor, add a Custom HTML block anywhere on the page and paste the generated code, including the script tags.
- SEO plugins: Rank Math and Yoast both include FAQ blocks that create the visible FAQ and the schema together. If you use one of those, do not also paste this code for the same questions.
- Header insertion: a header and footer code plugin can place the code in the page head, but make sure it only loads on the right page.
After publishing, test the URL with Google’s Rich Results Test or the Schema Markup Validator at validator.schema.org to confirm there are no syntax errors.
Best practices for FAQ markup
- Only mark up questions and answers that are visible on the page. Hidden or different content goes against Google’s structured data guidelines.
- Write the question as a user would ask it, and answer it in the first sentence.
- Do not use FAQPage for user-submitted questions with several answers; that is what QAPage is for.
- Avoid advertising copy in answers, and do not repeat the same FAQ across many pages.
- Keep the markup in sync when you edit the visible answers.
Frequently asked questions
Will FAQ schema give my site rich results in Google?
Probably not. Since August 2023 Google shows FAQ rich results only for well-known, authoritative government and health websites. The markup is still valid and can help other search engines and AI systems understand your content.
Is JSON-LD better than Microdata for FAQ schema?
Google supports both, but recommends JSON-LD because it is easier to add and maintain. Use one format for a given FAQ, not both.
Do the questions need to be visible on the page?
Yes. Structured data should describe content that users can actually see on the page. Marking up hidden questions breaks Google’s guidelines.
How do I test my FAQ schema?
Paste the page URL or code into Google’s Rich Results Test or the Schema Markup Validator to check for errors before and after publishing.
