Generate an FAQ accordion block with structured data
The reason to have an FAQ on a page is not just user experience — it is to earn FAQ rich snippets in Google. When done right, your page takes up more vertical space on the SERP and your CTR goes up.
To earn that snippet, the content needs to be wrapped in FAQPage JSON-LD with Question and Answer sub-types. Most accordion blocks either skip this or emit malformed schema.
Why generate it instead of installing an existing plugin?
Rank Math and Yoast offer FAQ blocks that emit schema correctly, but they live inside their full SEO suites. If you do not use their SEO plugin, installing a 5MB SEO toolkit for one block is heavy.
A dedicated FAQ accordion block ships ~3KB: native <details>/<summary> for progressive enhancement, keyboard-accessible triggers, proper aria attributes, and the JSON-LD schema emitted server-side so it is visible to crawlers.
The block validates against the FAQPage schema spec before rendering. Malformed entries (missing answer, duplicate question) are flagged in the editor so they never ship broken to production.
Example prompt
This is the kind of description that generates this plugin. You can start from it and tweak whatever you need before hitting generate.
Plugin name: Acme FAQ
Block acme/faq-accordion with InnerBlocks of acme/faq-item.
Item attributes: question (string), answer (rich text).
Render:
- <section itemscope itemtype="https://schema.org/FAQPage">
- Each item as <details> with summary being the question.
- Emit JSON-LD FAQPage block in the footer of the post with mainEntity array.
Editor:
- Shows a warning if an item has empty question or answer.
- Warn if the same question appears twice (Google dedupes them and may flag).
Keyboard: Tab cycles questions, Enter toggles, Esc closes all open.
Prefers-reduced-motion: disable the slide animation.What the generated plugin typically includes
- Parent + child block structure for Q/A pairs
- Native <details>/<summary> for zero-JS fallback
- JSON-LD FAQPage schema emitted server-side
- Editor validations (empty items, duplicates)
- Keyboard shortcuts and reduced-motion respect
Number of items, toggle animation, and whether only one item can be open at a time are set per-instance. For >20 questions, we recommend splitting by category for a better UX.
Frequently asked questions
Will Google show my FAQ in search results?
Google picks sites case by case. Having valid schema and genuinely helpful answers is the baseline; the rest is their algorithm. We validate the JSON-LD so you meet the technical bar.
What if the same FAQ block is on multiple pages?
That is fine, but Google may only show the snippet on one canonical URL. Make sure the authoritative FAQ has the schema and the others either skip it or link back.