⚡ BreezyTools Pro — Ad-free experience across all 200+ tools. Less than a coffee a month → Learn More

FAQ Schema Generator

Build valid FAQPage JSON-LD from question and answer pairs, then copy or download the markup.

Waiting for input

What FAQPage structured data is

FAQPage is a schema.org type for a page that lists questions, each with one answer written by the site owner. Describing them in JSON-LD lets search engines read the questions and answers without guessing from the page layout. The structure is short: a FAQPage whose mainEntity is a list of Question items. Each item has a name (the question) and an acceptedAnswer of type Answer, whose text holds the answer.

How to use the generator

  1. Type each question and answer into an item card, or click Load Sample to see the format. Click + Add FAQ Item for more cards.
  2. Only items with both a question and an answer are included. The badge shows how many are valid.
  3. Copy the JSON-LD or download it as faq-schema.jsonld.
  4. Wrap it in a script tag and add it to the page's HTML, in either the head or the body.
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How long does shipping take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Orders ship within 2 business days and usually arrive within a week."
      }
    }
  ]
}
</script>

The output is built with JSON.stringify, so quotes, line breaks, and other special characters in your answers are escaped correctly. Your text stays in your browser and isn't sent anywhere.

Google's rules for question-and-answer markup

  • The content must be visible. Every question and answer in the markup has to appear on the page. Text in expandable accordions counts. Markup that describes content users can't see breaks Google's structured data guidelines.
  • Match the text. Include the full question and the full answer, ideally word for word as displayed.
  • Use one answer per question, written by you. If users can post answers, as in a forum or product Q&A, use QAPage instead.
  • Don't use it for advertising. The markup is for real questions, not promotional copy.
  • Mark up repeated content once. If the same question and answer appear on several pages, add the markup to only one of them.

Will it produce rich results?

Probably not, unless you run a well-known government or health website. Since August 2023, Google has limited FAQ rich results, the expandable questions under a search listing, to those authoritative sites. For everyone else, FAQPage is still valid schema.org markup. Google still documents it, and unused structured data doesn't cause problems in Search. It describes your content in a machine-readable way, but don't expect it to change how your listing looks. Most of the value comes from the visible question-and-answer section, which helps readers and search engines understand what the page covers.

Writing answers worth marking up

  • Answer in the first sentence, then add detail.
  • Make each answer self-contained, since it may be read out of context.
  • Use the same wording in the markup as on the page, and update both together.
  • Check the finished page with Google's Rich Results Test and the Schema Markup Validator.

Frequently Asked Questions

Is FAQ schema still worth adding?

Yes, if the page already has a real, visible set of questions and answers. Most sites no longer get FAQ rich results, but the markup is valid, harmless, and quick to add. Don't write a question-and-answer section just to have something to mark up. Add one when visitors genuinely need it.

Where should I put the JSON-LD on my page?

Put it in a <script type="application/ld+json"> element in either the head or the body. Use one FAQPage block per page containing all its questions. Google can read JSON-LD injected with JavaScript, but markup in the static HTML is the most reliable.

Can I add FAQPage markup to every page of my site?

Only to pages that display their own questions and answers. If the same block of questions appears on many pages, such as a sitewide footer, mark up just one instance. Never mark up questions that aren't visible on the page.

What is the difference between FAQPage and QAPage?

FAQPage is for a list of questions you answer yourself, one answer each. QAPage is for a page built around a single question where users can submit answers, as on a forum or support community.

Can answers contain links or formatting?

Yes. Google accepts a limited set of HTML in the answer text: headings, paragraphs, line breaks, ordered and unordered lists, links, and bold or italic tags. Any HTML you type into the answer box is included as written, so keep it to those tags.

How do I test my FAQPage markup?

Paste the page URL or code into the Schema Markup Validator (validator.schema.org) to confirm the structure is valid. Then use Google's Rich Results Test or Search Console's URL Inspection to see how Google reads the page.

Power up your SEO workflow

BreezyTools Pro removes all ads, gives you early access to new tools, and supports ongoing development. Less than a coffee a month.

See Pro Plans →