FAQ Schema Generator

Turn the questions and answers already on your page into FAQPage JSON-LD. You get a live preview, a warning for every missing required field, and a link to Google's Rich Results Test.

Since September 14, 2023, Google only shows FAQ rich results for well-known, authoritative government and health websites. The JSON-LD is still valid schema.org. Other search engines and AI tools can read it. It is not a ranking boost, and it will not add stars.

Question 1

Preview of the visible FAQ

Google's guidelines say the questions and answers must be visible on the page. This preview is the text your markup should match, not a promise of a Google dropdown.

Add a question to see the preview.

JSON-LD

Rich Results Test ↗

Missing required fields

  • Question 1 is missing its text (Question.name).
  • Question 1 is missing the answer text (acceptedAnswer.text).

Recommended fields still open

  • Add the page URL so this FAQPage points at the page where the questions are visible.
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "inLanguage": "en"
}
</script>

Paste the script into the page HTML, in the head or before </body>. Then open Google's Rich Results Test, choose the code tab, and paste it again.

FAQPage on schema.org · Google's documentation

Want the marketing handled too?

SEOchat publishes pages about your business, keeps your Google listing active, and reports results every week. Starter is $99/month. Growth is $179/month. Cancel anytime.

A business name and website you already typed are carried into checkout. They do not change the price.

What FAQ schema is

FAQ schema is FAQPage markup from schema.org. It is a list of questions and answers, not a review and not a how-to. Each entry has the question text in Question.name and the full answer in acceptedAnswer.text. One accepted answer per question is the shape Google documents. This generator writes that shape and nothing else.

Will the rich result show?

Google's own documentation update on September 14, 2023 says the FAQ rich result is only shown for well-known, authoritative government and health websites. A plumber, a dentist, or a shop should not expect the dropdown. Publish the markup because it matches the visible FAQ and because other systems can read it, not because it will decorate the Google listing.

How to add this markup

  1. Put the questions and answers on the page in normal text. The preview in the tool is the checklist: if a line is not on the page, delete it here.
  2. Enter the page URL and the same words. Reorder them to match the page.
  3. Clear the required warnings. A question with no answer, or an answer with no question, is left out of the JSON-LD on purpose.
  4. Copy the script into the page HTML.
  5. Paste it into the code tab of Google's Rich Results Test. A valid test does not mean Google will show a dropdown.

Mistakes that get markup ignored

  • Writing questions that exist only in the script.
  • Using the FAQ block as an advertisement, with no real question.
  • Putting several answers under one question. This tool keeps one accepted answer, which is what Google's FAQ type describes.
  • Expecting stars, a ranking jump, or the old accordion. None of those come from FAQPage for a typical business.

The schema markup generator lists the other types. An article that answers one topic in prose, rather than as a question list, belongs in the article schema generator. A shop's name, address, and hours belong in the local business schema generator.

Questions

What is an FAQ schema generator?

It writes FAQPage structured data. Each question becomes a Question with a name, and each answer becomes an acceptedAnswer with the full text. The result is JSON-LD you can paste into the page.

Will Google show my FAQ dropdown?

Probably not. On September 14, 2023, Google limited FAQ rich results to well-known, authoritative government and health websites. Other sites can still publish valid FAQPage markup. It will not create the old expandable list in Google for a typical local business.

Does FAQ schema help me rank?

No. FAQ markup is not a ranking factor. Its job is to state the questions and answers in a format machines can read. The words on the page are what people and ranking systems actually use.

What are the required FAQ fields?

Google's FAQPage type needs mainEntity, and each question needs a name plus acceptedAnswer.text. This generator treats those as required. A page URL is recommended so the block points at the page where the FAQ is visible.

When should I use QAPage instead?

Use FAQPage only when you wrote the answers. If visitors submit their own answers, the page is a QAPage, and this tool is the wrong type.

Can I mark up questions that are only in the code?

No. Google's structured data guidelines say the content has to be visible. If the preview here does not match a list on the page, do not publish the script.

More free tools

See all tools