FAQ schema generator
FAQ schema generator
Turn question and answer pairs into FAQPage JSON-LD, with the answers kept as the text a reader can already see on the page.
How this is calculated
Each line is split on the first vertical bar. The left side becomes the name of a Question, the right side the text of an acceptedAnswer. The questions are collected into mainEntity on a FAQPage. Lines without a separator are reported rather than guessed at.
- FAQ rich results are restricted. Google announced in 2023 that they would be shown only for well-known, authoritative government and health websites, so valid FAQPage markup on an ordinary commercial site will not produce the expandable result. The markup still describes the page correctly and is still worth getting right.
- The answers must be the answers on the page. Markup that contains text a reader cannot see, or that contradicts what is displayed, is a guidelines violation rather than an optimisation.
- Do not use FAQPage for a single question, for advertising copy, or for a list of questions with no answers. Each Question needs exactly one acceptedAnswer.
FAQPage markup describes a list of questions and the answers that sit beside them on the page. It is straightforward to build and, since 2023, much less likely to produce a visible result than it used to be.
The rich result is restricted
Google announced in 2023 that FAQ rich results would be shown only for well-known, authoritative government and health websites. Valid FAQPage markup on an ordinary commercial or news site will therefore not produce the expandable question-and-answer block in a result, however correctly it is written.
The markup still describes the page accurately and is still worth getting right — it costs nothing, it may be consumed by other clients, and the restriction is a policy that could change. What is not worth doing is building FAQ markup in the expectation of a rich result that the policy currently withholds.
What belongs in the answers
The answers must be the answers on the page. Markup containing text a reader cannot see, or contradicting what is displayed, is a guidelines violation. Simple HTML such as a link or a list is permitted inside an answer; the generator writes what you type as the answer text.
FAQPage is not for a single question, for advertising copy, or for a list of questions with no answers. Each Question takes exactly one acceptedAnswer, and lines that cannot be split into a question and an answer are reported rather than guessed at.
Questions readers ask
How do I format the input?
One pair per line, question first, then a vertical bar, then the answer. The split happens on the first bar, so an answer may itself contain one.
Is there a limit on the number of questions?
The schema does not impose one. Practically, the questions should be the ones the page actually answers, and a page with forty FAQs is usually a page that should have been four pages.
More in Markup, feeds and tagged links
SEO and website tools
Titles and snippets measured, copy counted and scored, and the markup a page needs built in the browser and copied out.
- robots.txt generator Build a robots.txt from the paths you want crawled and the ones you do not, with your sitemap declared and the rules ordered so a specific allowance is not swallowed by a broad block.
- XML sitemap generator Turn a list of URLs into a valid urlset sitemap, with duplicates removed, XML escaping applied and the protocol limits checked against what you pasted.
- Schema markup generator Build JSON-LD for a website, an organisation, an article or a breadcrumb trail from fields you fill in, with the properties each type requires present before the block is written.
- FAQ schema generator Turn question and answer pairs into FAQPage JSON-LD, with the answers kept as the text a reader can already see on the page.
- Hreflang tag generator Build the alternate-language link set for a page, including the x-default entry, from the language and region codes and URLs you supply.
- Open Graph and Twitter card generator Build the Open Graph and Twitter card meta tags for a page, with the image dimensions you supply deciding which card type is honest to claim.
- UTM link builder Add campaign parameters to a URL with the values encoded properly, keeping any query string and fragment already on the link intact.