4WP FAQ

4WP FAQ wraps WordPress core Accordion blocks so you can keep your design and still get:

• FAQPage JSON-LD for Google rich results (off by default; turn on when you are ready)
• An optional FAQ registry that aggregates questions across the site after a scan
• Hub pages with List + Categories blocks, pretty category URLs, category SEO titles, and drag-and-drop category order (admin + front end)
• Drag-and-drop FAQ category order on FAQ → Categories — same order in admin lists and on the front end (List / Categories hub)

A plugin by 4wp.dev. 4WP is our project brand; this plugin is not affiliated with, endorsed, or sponsored by WordPress.

Source: github.com/4wpdev/4wp-faq

How to work with it (short path)

1. In the editor, add a core Accordion (or select an existing one).
2. Click Convert to FAQ in the block toolbar (or insert the 4WP FAQ block). You can also select existing Details, Accordion, or heading + paragraph blocks and use Transform to → 4WP FAQ.
3. Put the question in the Accordion Item heading and the answer in the panel.
4. Open FAQ → Settings and enable FAQPage JSON-LD if you want structured data on the front end.
5. Optional: complete registry setup → Rescan (Dashboard or Settings) → place 4WP FAQ List and 4WP FAQ Categories on a hub page or template.

Registry posts are created by the scan. Do not create them by hand under “Add New”.

Blocks

• 4WP FAQ (forwp/faq) — wrap Accordion / Accordion Item for JSON-LD and registry scan
• 4WP FAQ List (forwp/faq-list) — registry glossary: grouped or flat, include/exclude categories
• 4WP FAQ Categories (forwp/faq-categories) — category nav that filters the List
• 4WP FAQ Count (forwp/faq-count) — live count for All / category / search ([forwp_faq_count])
• 4WP FAQ Card (forwp/faq-card) — inner card for the List (not in the inserter)

Key features

• Wrap Accordion / Accordion Item (legacy Details still supported)
• FAQPage JSON-LD in the document head — site-wide toggle plus per-block override
• Optional FAQ registry CPT with scan and “Used in” source links
• FAQ categories — manage in admin, assign per block, or create on scan from the page
• Admin Dashboard — status metrics, Rescan, hierarchical categories, reused / uncategorized
• FSE hub blocks — List, Categories, Count, Card
• Preview count per category on the All view + optional pretty category URLs (/hub-page/term-slug/)
• Category SEO title / description fields; filled SEO title is used as-is (no site-name suffix)
• Drag-and-drop category order on FAQ → FAQ Categories — same order in admin lists, Dashboard, and front-end List / Categories blocks
• Polylang — categories follow the language of the page that owns the FAQ block
• Setup wizard for registry post type and taxonomy slugs
• Convert to FAQ toolbar and Transform to → 4WP FAQ (Accordion, Details, List, heading + paragraph — one or many); default Accordion template on insert

Development

JavaScript and CSS are built with @wordpress/scripts. Human-readable source (src/, webpack.config.js, package.json) is in the public GitHub repository — not in the distributed ZIP.

From a clone:

1. cd into the plugin directory
2. npm install
3. npm run build — compiles block, admin, and setup apps into build/