GuidesSEO

How to add FAQ schema markup

Add FAQPage structured data as JSON-LD to a page that shows real questions and answers, then test it with Google’s Rich Results Test. Since 2023, Google shows FAQ rich results only for well-known government and health sites, so for most businesses the value is clarity, not a visible snippet.

Updated November 16, 20265 steps5 min read

Grow my organic traffic →

$1 today. Cancel anytime before day 7.

Add FAQ schema
  1. 1Write visible Q&AsPut real questions and answers on the page for readers.
  2. 2Mark them upAdd FAQPage JSON-LD with each question and its accepted answer.
  3. 3Match the pageEvery question and answer in markup must be visible on the page.
  4. 4ValidateRun the Rich Results Test and fix errors.
  5. 5MonitorCheck Search Console for enhancement errors and impressions.
On this page
  1. Does FAQ schema still work?
  2. The markup, in JSON-LD
  3. Rules that keep it valid
  4. A FAQ schema example
  5. Why the questions still matter without the rich result
  6. Test it and decide where it belongs
  7. Questions

Does FAQ schema still work?

Partly. In August 2023 Google limited FAQ rich results to well-known, authoritative government and health websites. For other sites, FAQPage markup is still valid and harmless, but it no longer produces the expandable questions under a result in Google Search.

So why add it? It states the page’s structure in a machine-readable way, other search engines and tools may use it, and it forces you to write questions in the form people ask. Do not add it expecting a visual change, and do not add it to pages that are not real FAQs.

A related change: Google also limited HowTo rich results in 2023. The pattern is the same, which is that Google narrows the types of structured data that earn a visible result. Check the current list of supported rich results in Google’s documentation before investing in any markup type, and add markup because it describes the page well.

The markup, in JSON-LD

Google recommends JSON-LD, placed in a script tag in the head or body. The structure is a FAQPage whose mainEntity is a list of Question items, each with a name (the question) and an acceptedAnswer of type Answer whose text is the answer. Answers can include basic HTML such as links and lists.

Use one Question per real question, written the way a person would ask it, with the answer text matching what appears on the page. A page should have one FAQPage block, not one per question.

Most CMS plugins and page builders will write this for you, and a hand-edited block is easy to get wrong. If you write it yourself, keep it in a template that pulls from the same data as the visible questions, so the two cannot drift apart. That way an edit to an answer on the page updates the markup without a second step.

Want the articles written for you?

Researches keywords and what competitors rank for. Publishes to WordPress, Webflow, Shopify or Framer once you approve.

Rules that keep it valid

The markup must reflect content the visitor can see. Hidden questions, or answers that differ from the page, break Google’s structured data guidelines. FAQPage is for pages where the site owner writes the answers; a forum or a page where users submit answers uses a different type, QAPage.

Do not use it for advertising or to push promotional copy. Keep answers concise and useful, two to four sentences, so they can be quoted by search and AI engines alike. Product schema and local business schema cover the types that still earn rich results.

Each question should have exactly one answer from the site owner, and the same question should not appear twice on the same page. If the same FAQ block is repeated across many pages, mark it up on one page, not all. Duplicating it adds nothing and looks like an attempt to game the markup.

A FAQ schema example

A minimal block has a script tag of type application/ld+json holding an object with “@context” pointing at the Schema vocabulary, “@type” set to FAQPage, and “mainEntity” as a list. Each list item has “@type” Question, a “name” with the question text, and an “acceptedAnswer” object with “@type” Answer and a “text” field holding the answer.

So a page with two questions has one FAQPage, a mainEntity list of two Question items, and two Answer objects. Escape quotation marks inside the text, and keep the wording identical to what the page shows. A page-level error such as a missing comma will invalidate the whole block, which is why you validate it.

Why the questions still matter without the rich result

A well-built FAQ section still does work. Searchers and AI engines pick up short, direct answers, so a question written the way people ask it, answered in two to four sentences, has a chance of being quoted even with no rich result.

Source the questions from real searches: People Also Ask, support emails, sales calls and the queries Search Console shows. Answer each directly in the first sentence, and link to the longer page for detail. The goal is useful content, with schema as a label on top of it.

Test it and decide where it belongs

Paste the URL or code into Google’s Rich Results Test, fix any errors, and check the Search Console enhancements report after Google recrawls. The URL Inspection tool shows when that happened; see the URL Inspection guide.

Put the format where a real FAQ exists: product and service pages, help articles and guides. The bigger payoff today is the answers themselves, which AI answer engines quote; see FAQ and answer content for AI. Sprites writes and updates pages and their meta titles and descriptions, and publishes to your CMS only after approval.

If you use a CMS plugin, check what it generates, since some add FAQ markup automatically to every page with an accordion. Look at the output in the Rich Results Test, and turn the feature off on pages where the questions are not real.

Questions

Does FAQ schema still work?

The markup is valid, but Google shows FAQ rich results only for well-known government and health sites. For most sites there is no visible rich result, though the markup does no harm.

Is FAQ schema deprecated?

Not removed. Google still documents FAQPage, but limited the rich result in 2023. Check Google’s current structured data documentation, as eligibility can change.

What is a FAQ page?

A page of frequently asked questions with answers written by the site owner. A single page with questions and answers on a topic can be marked up with FAQPage.

What is schema on a website?

Schema is a shared vocabulary for describing page content to machines, usually added as JSON-LD. It labels things like products, articles, businesses and questions.

Can I use FAQ schema on every page?

Only on pages that actually contain visible questions and answers. Marking up content that is not on the page violates Google’s guidelines.

Keep going

Have Sprites grow your organic traffic

  • Researches keywords and what competitors rank for
  • Audits your pages and writes the articles
  • Publishes to WordPress, Webflow, Shopify or Framer once you approve