How to Create FAQ Schema (FAQPage JSON-LD)

FAQ markup is a way of telling search engines that a block of your page is a set of questions and answers. It is easy to generate, but Google has retired the feature it was best known for.

What the tool creates

Fill in a question and answer in the FAQ Schema Generator, up to three pairs, and it returns a script block like this for one pair:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Is it free?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes."
      }
    }
  ]
}
</script>

Using it

1. Enter one to three question and answer pairs. Leave the others empty.
2. Copy the generated code.
3. Paste it into the page’s HTML, in the head or body.
4. Test it with a structured data testing tool.

Rules that matter

• The questions and answers in the markup must also be visible on the page. Hidden or mismatched markup goes against search engine guidelines.
• Use it for genuine FAQs written by you, not for ads or for user-submitted content.
• Keep answers short and accurate.

What to expect

Google limited FAQ rich results to a few well-known government and health sites in 2023. In 2026 it announced the feature’s retirement, and its documentation now states that the FAQ rich result is no longer shown in Google Search. The markup is still valid schema.org data and other tools may read it, but do not add it expecting a visible change in Google, and it is not a ranking boost.

The glossary explains JSON-LD.

Frequently asked questions