SEOANALİZİN · SEO GUIDE

How to Add FAQ Schema: JSON-LD Example

A JSON-LD example of FAQPage markup, the post-2023 restrictions and why a Q&A section is valuable even without markup.

How to Add FAQ Schema: JSON-LD Example

FAQPage is the schema type that marks up questions and answers on a page. One important update: since August 2023, Google shows FAQ rich results only for well-known, authoritative government and health sites. So for most sites the markup no longer produces an expandable question box in search results. Correct use is still harmless, and it may help some other systems understand the content.

Comparison of FAQ schema before and after 2023
Google's restriction does not invalidate the markup; it only narrows the rich appearance.

First question: is it worth adding?

  • If your goal is an expandable FAQ box in search results, that is no longer possible for most sites.
  • If the page has a real FAQ section, marking it up is still correct and clean.
  • The real value is not the markup but the answer itself being short, clear and visible on the page.

Example JSON-LD

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Is a sitemap required?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "No, but it makes discovery of your site easier."
      }
    },
    {
      "@type": "Question",
      "name": "Where do I add the sitemap?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "In Search Console and in robots.txt."
      }
    }
  ]
}
</script>

FAQ markup rules

  • Questions and answers must be visible on the page; text that exists only in the markup breaks the guidelines.
  • Each question must have a single, fixed answer. On forum pages where users write answers, QAPage is used instead of FAQPage.
  • Using it for advertising or repeating the same FAQ across hundreds of pages adds no value.

Validating FAQ markup

  1. Produce the JSON with the Schema Generator or write it by hand.
  2. Confirm validity with the Schema Checker and Google's Rich Results Test.
  3. Even if the test shows no eligibility, no syntax errors is enough.

For the general concepts, see the schema markup guide.

Win even without markup

Keep answers visible, pick questions from real searches and answer directly in the first sentence. This format suits both readers and AI summaries: see the GEO guide.

How to write the answers

Whether or not markup is used, a good FAQ answer has three traits:

  • The first sentence is the answer: “Yes,” “No” or a clear piece of information.
  • It is short: usually 1–3 sentences; if detail is needed, link to the relevant section of the page.
  • It comes from a real question: Search Console queries and “People also ask” suggestions are the best source.

Straight answers on FAQ schema

Does FAQ schema still work?

It is technically valid, but Google's FAQ rich result is now shown only for certain government and health sites.

Should I remove my FAQ?

No. Useful FAQ sections help users. Just do not expect the appearance the markup used to bring.

What about HowTo schema?

Google removed HowTo rich results in 2023.

SEOANALİZİN Editorial TeamSEO and technical content

We publish practical guides on search visibility, rankings and content quality, based on transparent methods and relevant sources.

SHARE

Share this guide

Send the guide to your team or share it with your audience.

COMMENTS

Join the discussion

Share your experience or ask a question about this guide.

0 comments
Guest comments are reviewed before publication.
No comments yet. Be the first to share your thoughts.