Check explainer · v1

FAQPage markup: valid questions or none at all

Automated

Last reviewed

Google retired FAQ rich results for most sites, so FAQPage markup is optional now. What still matters: markup you ship has to parse as real questions — a broken block is a defect, its absence is not.

How this check works

Pages without FAQPage markup are not judged — absence is harmless now that the rich result is deprecated. Shipped markup is graded: mainEntity must hold Question entries with a non-empty name. A block whose questions cannot be read fails; a well-formed block passes with its question count stated.

What does a failure look like?

A plugin emits an FAQPage wrapper with an empty mainEntity; hand-rolled blocks where the questions are plain strings instead of Question entities; a migration that renames or reshapes the block and leaves nothing for a parser to read.

How to fix it, step by step

  1. Decide first whether the page needs FAQ markup at all — without rich results it is a machine-readability choice, not a traffic lever.
  2. Give every question a Question entity with a non-empty name, and keep answers as acceptedAnswer text.
  3. Validate the block after plugin or theme updates — FAQ plugins rewrite their output silently and often.

What does a pass or fail look like?

Good

FAQPage with 6 Question entries, each carrying a name and an accepted answer.

Fail

A FAQPage block ships with mainEntity: [] — nothing for a parser to read.

Frequently asked questions

Are FAQ rich results still worth shipping?

Google restricted FAQ rich results to well-known government and health sites in 2023, so most pages no longer get the treatment. The markup still helps machines read Q&A content — ship it for that, not for the deprecated display.

Why does an empty FAQPage fail instead of being ignored?

Shipping markup that parses to nothing is a defect, not an absence: whatever emitted it is broken, and the same code path is probably emitting worse on other templates.

Does this check require FAQ markup on every page?

No. A page without FAQPage markup is not judged at all. Only pages that declare the type are graded on its structure.

This rule is one of the checks the audit runs. Run the full site audit

Free preview; no account needed.

Visdenda check explainers · one page per published ruleFAQ markup · v1