4WP FAQ

Description

4WP FAQ is a smart wrapper around WordPress core Accordion blocks. It adds FAQPage JSON-LD, an optional aggregated FAQ registry, and usage context while keeping your front-end design intact.

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

Source code and releases: github.com/4wpdev/4wp-faq

Blocks

• 4WP FAQ (forwp/faq) — wrap Accordion / Accordion Item for FAQPage 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 (Interactivity API)
• 4WP FAQ Count (forwp/faq-count) — live count for All / current category / search ([forwp_faq_count])
• 4WP FAQ Card (forwp/faq-card) — inner card for the List (not shown in the inserter)

Development

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

From a clone of the repository:

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

Key features

• Wrap Accordion / Accordion Item (legacy Details supported)
• FAQPage JSON-LD — site-wide toggle plus per-block override; hub pages output the questions actually shown
• Optional FAQ registry CPT with content scan and usage stats (“Used in” sources)
• FAQ categories — create in admin, pick per block, or auto-create on scan from the page
• FSE hub blocks — List, Categories, Count, and Card for registry-powered FAQ archives
• Preview count per category on the All view + optional pretty category URLs
• Drag-and-drop category order on the taxonomy screen
• Polylang — registry categories respect the language of the page where the FAQ block lives
• Setup wizard for registry post type and taxonomy slugs
• Convert to FAQ toolbar action on Accordion blocks
• Default Accordion template when inserting the FAQ block; Add FAQ item in the editor

How it works

1. Build FAQs with core Accordion blocks (or convert existing Accordion).
2. Click Convert to FAQ to wrap content in forwp/faq.
3. Enable JSON-LD in FAQ → Settings (recommended for SEO) or per block.
4. Optionally complete setup to aggregate questions into a registry list, then place List + Categories on a hub page.

JSON-LD on the front end does not require the registry. The registry is for browsing, reuse tracking, and hub layouts.