Title: Accordion FAQ – FAQ Schema, Block & Shortcode with Live Search
Author: Mahesh Patel
Published: 4. Dezember 2015
Last modified: 5. Juli 2026
---
Plugins suchen
# Accordion FAQ – FAQ Schema, Block & Shortcode with Live Search
Von [Mahesh Patel](https://profiles.wordpress.org/maheshpatel/)
[Herunterladen](https://downloads.wordpress.org/plugin/accordion-faq-plugin.4.1.0.zip)
* [Details](https://de.wordpress.org/plugins/accordion-faq-plugin/#description)
* [Rezensionen](https://de.wordpress.org/plugins/accordion-faq-plugin/#reviews)
* [Installation](https://de.wordpress.org/plugins/accordion-faq-plugin/#installation)
* [Entwicklung](https://de.wordpress.org/plugins/accordion-faq-plugin/#developers)
[Support](https://wordpress.org/support/plugin/accordion-faq-plugin/)
## Beschreibung
**Accordion FAQ** is the fast, accessible way to build an **FAQ page** in WordPress.
Create beautiful **accordion FAQs** with the **Gutenberg FAQ block** or a **shortcode**,
output valid **FAQ schema** (FAQPage JSON-LD) for Google rich results, and let visitors
find answers instantly with **live search** and category filters.
Whether you need a simple frequently-asked-questions section on a landing page,
a full searchable knowledge base, or product FAQs on a WooCommerce store, Accordion
FAQ gives you a lightweight, SEO-ready toolkit that works with **any theme** — no
page builder required, no jQuery, and no bloat.
> **Built for speed and SEO.** Assets load only on pages that actually contain an
> FAQ, structured data is generated server-side for Google rich results, and every
> FAQ is fully keyboard accessible out of the box.
#### Why choose Accordion FAQ?
* ✅ **Rank in Google** with valid FAQPage JSON-LD structured data (schema).
* ✅ **Add FAQs anywhere** — Gutenberg block, shortcode, Elementor widget, or WooCommerce
product tab.
* ✅ **Truly accessible** — the WAI-ARIA Accordion pattern with full keyboard navigation.
* ✅ **Blazing fast** — conditional asset loading, no jQuery, scalable CSS icons.
* ✅ **Beautiful by default** — six styles, light/dark aware, and fully customizable.
* ✅ **Grows with you** — search, filtering, analytics, voting, visitor submissions,
and AI.
#### Add FAQs your way
* **Gutenberg FAQ block** — an “Accordion FAQ” block with a live preview, full-
site-editing (FSE) support, and one-click **AI generation** right in the editor.
* **Shortcodes** — drop `[accordion_faq]` (or the classic `[quick_faq]`) into any
page, post, or widget.
* **Page builders** — native elements for **Elementor, WPBakery, Divi, Bricks,
and Beaver Builder**.
* **WooCommerce tab** — automatically add an FAQ tab to your product pages, with
an optional **per-product FAQ picker**.
#### FAQ schema for Google rich results
Accordion FAQ outputs a single, **deduplicated FAQPage JSON-LD** block server-side
so search engines can understand your questions and answers. Schema can be toggled
globally or per instance — so if an SEO plugin such as Yoast or Rank Math already
outputs FAQ schema, you can disable ours in one click to avoid duplicate structured
data.
#### Accessibility first
Accordion FAQ implements the full **WAI-ARIA Accordion design pattern**:
* Real `` triggers with `aria-expanded` and `aria-controls`.
* Arrow-key navigation, Home/End support, and visible focus states.
* Honors the visitor’s `prefers-reduced-motion` setting.
* A zero-JavaScript native ``/`` engine for maximum compatibility.
#### Live search & filtering
* **Live search with highlighting** — visitors filter questions as they type, with
matches highlighted.
* **Search autocomplete** — a suggestion dropdown searches your entire FAQ library(
REST-backed) and jumps straight to the answer.
* **Category filter tabs** — one-click filtering by FAQ category.
* **Expand / collapse all** — reveal or hide every answer at once.
* **Sticky table of contents** — an optional scroll-spy sidebar for long FAQ pages.
* **Pagination / “Load more”** — keep long libraries snappy.
* **#anchor deep-linking** — link directly to a specific question.
#### Styles & design
* Six styles: **Minimal, Bordered, Filled, Separated, Card, and Modern**.
* Icon styles: **chevron, plus, or arrow**, positioned left or right.
* **Accordion** (one open at a time) or **Toggle** (many open) modes.
* Light/dark aware, styled with CSS variables, and **theme-overridable templates**.
#### Engagement & analytics
* **FAQ analytics** — track views and see your most-viewed FAQs.
* **“Was this helpful?” voting** — collect helpful / not-helpful feedback.
* **Search-term analytics** — see what visitors search for, and which queries return**
no results** so you can spot content gaps.
* **Visitor-submitted questions** — let users ask questions from the front end
with moderation (pending review), **admin email notifications**, and layered
anti-spam (honeypot + timing + rate limiting).
* **Drag-and-drop ordering** — reorder FAQs directly in the admin list.
* **Analytics dashboard** — 30-day trend charts and top-FAQ rankings.
#### AI, import & export
* **AI FAQ generation** — describe a topic and generate ready-to-edit questions
and answers using the WordPress core AI client (no third-party API key required).
* **CSV / JSON import & export** — move your FAQ library in and out in seconds.
#### Developer friendly
* Modular, namespaced OOP with a clean autoloader.
* Hooks and filters throughout, plus fully overridable templates.
* A REST API under `accordion-faq/v1` (analytics, server-side search, submissions,
AI).
#### Perfect for
* SaaS and product **FAQ pages** and pre-sales questions.
* **Knowledge bases** and support / help centers.
* **WooCommerce** product FAQs and shipping/returns policies.
* Documentation, onboarding, and “Getting started” sections.
* Any page that needs a clean, searchable, SEO-ready **accordion**.
#### Shortcodes
```
[accordion_faq] — the canonical shortcode with full options:
category, `term`, `ids`, `style`, `mode`, `engine`, `heading`, `icon`, `orderby`, `order`, `limit`, `open_first`, `search`, `filter`, `expand_all`, `toc`, `per_page`, `schema`, `class`.
```
Examples:
* `[accordion_faq]` — show all FAQs with your global defaults.
* `[accordion_faq category="billing" mode="toggle" search="1"]` — a searchable “
Billing” FAQ where multiple answers can stay open.
* `[accordion_faq ids="12,15,18" style="card" icon="plus"]` — show three specific
FAQs in the Card style.
* `[quick_faq id="12"]` — classic shortcode: show FAQs in category (term) `12` (
fully backward compatible).
* `[accordion_faq_submit]` — render the front-end “ask a question” submission form.
#### FAQ custom post type
FAQs are stored as a `quick_faq` post type with a `quick_faq_tax` category taxonomy.
Add your **question as the post title** and the **answer in the editor**, assign
a category, and you’re done. Manual ordering lets you control exactly which question
appears first.
## Screenshots
[⌊The accessible FAQ accordion on the front end, with live search and category filter
tabs.⌉⌊The accessible FAQ accordion on the front end, with live search and category
filter tabs.⌉[
The accessible FAQ accordion on the front end, with live search and category filter
tabs.
[⌊The Accordion FAQ block in the Gutenberg editor with a live preview.⌉⌊The Accordion
FAQ block in the Gutenberg editor with a live preview.⌉[
The Accordion FAQ block in the Gutenberg editor with a live preview.
[⌊The branded settings screen — global defaults, styles, and schema controls.⌉⌊The
branded settings screen — global defaults, styles, and schema controls.⌉[
The branded settings screen — global defaults, styles, and schema controls.
[⌊The analytics dashboard with 30-day view trends and top-FAQ rankings.⌉⌊The analytics
dashboard with 30-day view trends and top-FAQ rankings.⌉[
The analytics dashboard with 30-day view trends and top-FAQ rankings.
[⌊The “Was this helpful?” voting widget and visitor question submission form.⌉⌊The“
Was this helpful?” voting widget and visitor question submission form.⌉[
The “Was this helpful?” voting widget and visitor question submission form.
[⌊Style gallery — Minimal, Bordered, Filled, Separated, Card, and Modern.⌉⌊Style
gallery — Minimal, Bordered, Filled, Separated, Card, and Modern.⌉[
Style gallery — Minimal, Bordered, Filled, Separated, Card, and Modern.
[[
[[
## Installation
**From your WordPress dashboard**
1. Go to **Plugins Add New** and search for “Accordion FAQ”.
2. Click **Install Now**, then **Activate**.
**Manual upload**
1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** screen in WordPress.
**Create your first FAQ**
1. Add FAQ categories under **FAQs Categories** (optional but recommended).
2. Add questions under **FAQs Add New** — the title is the question, the editor holds
the answer.
3. Insert the **Accordion FAQ** block, or paste `[accordion_faq]` into any page, post,
or widget.
4. Configure global defaults (style, mode, schema, search, and more) under **FAQs
Settings**.
That’s it — your accessible, SEO-ready FAQ is live.
## FAQ
### How do I create an FAQ page in WordPress?
Add your questions under **FAQs Add New** (title = question, editor = answer),
then create a page and insert the **Accordion FAQ** block or the `[accordion_faq]`
shortcode. Your questions render as an accessible accordion instantly.
### How do I add FAQ schema for Google rich results?
FAQ schema is on by default. Accordion FAQ prints a single, deduplicated **FAQPage
JSON-LD** block server-side so Google can read your questions and answers. You can
disable it globally or per instance under **FAQs Settings**.
### Will this conflict with the FAQ schema in Yoast or Rank Math?
No. If your SEO plugin already outputs FAQ schema for a page, simply toggle Accordion
FAQ’s schema off (globally or on that instance) so you never ship duplicate structured
data.
### Does it work with the Gutenberg block editor?
Yes. There is a dedicated **Accordion FAQ** block with a live preview, and it supports
full-site editing (FSE) themes.
### Does it work with page builders?
Yes. Accordion FAQ registers native elements for **Elementor, WPBakery, Divi, Bricks,
and Beaver Builder**, so you can drop an FAQ into any builder layout with a visual
control panel.
### Does it work with WooCommerce?
Yes. You can automatically add an **FAQ tab** to WooCommerce product pages — perfect
for shipping, returns, and pre-sales questions. A **per-product FAQ picker** lets
you choose exactly which FAQs (or category) show on each product, with a global
fallback.
### Is it compatible with my theme?
Yes. Accordion FAQ works with virtually any theme. It styles itself with CSS variables,
is light/dark aware, and its templates are fully overridable from your theme.
### Will it slow down my website?
No. CSS and JavaScript load **only** on pages that actually contain an FAQ. There
is no jQuery dependency, and the icons are scalable CSS (no image requests).
### Is the accordion accessible?
Yes. It implements the **WAI-ARIA Accordion pattern** with real button triggers,`
aria-expanded`/`aria-controls`, arrow-key navigation, visible focus, and `prefers-
reduced-motion` support. A zero-JavaScript native `` engine is also available.
### Does it work without JavaScript?
Yes. Switch the engine to the native ``/`` mode for a fully functional,
expandable FAQ that needs no JavaScript at all.
### Can visitors submit their own questions?
Yes. Add the `[accordion_faq_submit]` form so visitors can ask questions. Submissions
are held for moderation (pending review) and protected by layered anti-spam (honeypot
+ timing + rate limiting).
### Can I see which FAQs are most popular?
Yes. Built-in analytics track FAQ views and “Was this helpful?” votes, with a dashboard
showing 30-day trends and your top-performing questions.
### Can I generate FAQs with AI?
Yes. Describe a topic and Accordion FAQ generates ready-to-edit questions and answers
using the WordPress core AI client — no third-party API key required. You review
and publish before anything goes live.
### Can I import or export my FAQs?
Yes. Import and export your entire FAQ library as **CSV or JSON** from the admin
tools screen.
### Can I organize FAQs into categories?
Yes. FAQs use the `quick_faq_tax` taxonomy, so you can group questions by category
and show category filter tabs or target a single category in a shortcode/block.
### Can I change the colors and style?
Yes. Choose from six styles (Minimal, Bordered, Filled, Separated, Card, Modern),
pick an icon (chevron, plus, arrow), set its position, and fine-tune the accent
color — or override the CSS variables in your theme.
### Is it translation ready?
Yes. Accordion FAQ is fully internationalized and ready for translation into any
language.
### Will my old `[quick_faq]` shortcodes keep working?
Yes. The `quick_faq` post type, `quick_faq_tax` taxonomy, and `[quick_faq id="…"]`
shortcode from earlier versions continue to work unchanged.
## Rezensionen
### [Best Plugin](https://wordpress.org/support/topic/best-plugin-1334/)
[pbyteshub](https://profiles.wordpress.org/pbyteshub/) 19. Juli 2023
I've used this plugin. This plugin has lot of good functionalities to the newbies
to create a FAQ in easy way.
### [Translation](https://wordpress.org/support/topic/translation-599/)
[Grzegorz W](https://profiles.wordpress.org/grzegorz-w/) 3. September 2016
Translations not working. 🙁
### [Works but Beware](https://wordpress.org/support/topic/works-but-beware/)
[rory124](https://profiles.wordpress.org/rory124/) 3. September 2016
This plugin works as stated, but I am using the Vantage theme by AppThemes and this
plugin turns off the Listings option in the Wordpress and Theme dashboard. That
is not helpful.
### [Simple Accordion Faq's](https://wordpress.org/support/topic/simple-accordion-faqs/)
[Mahesh Patel](https://profiles.wordpress.org/maheshpatel/) 3. September 2016 10
Antworten
Simple and Easy to use accordion faq's plugin,just put shortcode in your page or
post.
[ Alle 4 Rezensionen lesen ](https://wordpress.org/support/plugin/accordion-faq-plugin/reviews/)
## Mitwirkende und Entwickler
„Accordion FAQ – FAQ Schema, Block & Shortcode with Live Search“ ist Open-Source-
Software. Folgende Menschen haben an diesem Plugin mitgewirkt:
Mitwirkende
* [ Mahesh Patel ](https://profiles.wordpress.org/maheshpatel/)
[Übersetze „Accordion FAQ – FAQ Schema, Block & Shortcode with Live Search“ in deine Sprache.](https://translate.wordpress.org/projects/wp-plugins/accordion-faq-plugin)
### Interessiert an der Entwicklung?
[Durchstöbere den Code](https://plugins.trac.wordpress.org/browser/accordion-faq-plugin/),
sieh dir das [SVN-Repository](https://plugins.svn.wordpress.org/accordion-faq-plugin/)
an oder abonniere das [Entwicklungsprotokoll](https://plugins.trac.wordpress.org/log/accordion-faq-plugin/)
per [RSS](https://plugins.trac.wordpress.org/log/accordion-faq-plugin/?limit=100&mode=stop_on_copy&format=rss).
## Änderungsprotokoll
#### 4.1.0
* Added: Search autocomplete — a REST-backed suggestion dropdown that searches
your entire FAQ library and jumps to the answer (keyboard accessible).
* Added: Live-search match highlighting on the front end.
* Added: Search-term analytics — see what visitors search for, including queries
that return no results (content gaps), on the analytics dashboard.
* Added: Sticky table-of-contents sidebar with scroll-spy for long FAQ pages.
* Added: Pagination / “Load more” for large FAQ libraries (per-page control in
Settings).
* Added: Drag-and-drop manual ordering on the FAQ admin list.
* Added: AI FAQ generation directly inside the Gutenberg block editor.
* Added: Per-product FAQ picker for WooCommerce (specific FAQs or a category, with
a global fallback).
* Added: Native page-builder elements for WPBakery, Divi, Bricks, and Beaver Builder(
joining Elementor).
* Added: Admin email notifications when a visitor submits a question.
* Added: CSV/JSON import now respects an exported `status` column (publish/draft/
pending/private).
* Added: Regenerated translation catalog (.pot) with all strings.
* Changed: Analytics tables now upgrade automatically on existing installs (no
reactivation required).
#### 4.0.0
* Added: A completely redesigned, product-grade admin experience — branded dashboard,
custom cards, toggle switches, segmented controls and a live preview (no plain
WordPress option tables).
* Added: FAQ analytics — view tracking, a “Was this helpful?” voting widget, an
analytics dashboard with 30-day charts and top-FAQ rankings.
* Added: Visitor-submitted questions with a shortcode form, moderation (pending
status) and layered anti-spam (honeypot + timing + rate limit).
* Added: AI FAQ generation via the WordPress core AI client (no third-party API
key required).
* Added: CSV/JSON import and export of your FAQ library.
* Added: Elementor widget and a WooCommerce product FAQ tab.
* Added: A REST API (analytics, server-side search, submissions, AI) under accordion-
faq/v1.
* Added: Premium styles (Modern, Card) and icon styles (chevron, plus, arrow).
* Added: Gutenberg block („Accordion FAQ“) with live preview and full-site-editing
support.
* Added: FAQPage JSON-LD structured data (server-rendered, deduplicated, toggleable).
* Added: Full keyboard accessibility and the WAI-ARIA Accordion pattern (button
triggers, aria-expanded/controls, arrow-key navigation, focus-visible).
* Added: Accordion (one open) and Toggle (many open) modes; open-by-default; native
zero-JavaScript engine.
* Added: prefers-reduced-motion support; multiple styles via CSS variables; light/
dark aware.
* Added: Live search, category filter tabs, expand/collapse all, and #anchor deep-
linking.
* Added: Settings page (global defaults), per-FAQ options (order, default-open,
icon), and a canonical `[accordion_faq]` shortcode.
* Added: Theme-overridable templates and a developer hook/filter API.
* Added: Proper internationalization and an opt-in uninstall cleanup.
* Changed: Complete re-architecture to modular, namespaced OOP with an autoloader.
* Changed: Assets now load only on pages that contain an FAQ; jQuery removed; the
bitmap arrow replaced with a scalable CSS icon.
* Fixed: Invalid CSS values, cross-instance JavaScript interference, the undefined
shortcode „id“ default, and unescaped output.
* Backward compatibility: the quick_faq post type, quick_faq_tax taxonomy, and [
quick_faq] shortcode continue to work unchanged.
#### 3.0.0
* Earlier releases provided the FAQ custom post type, taxonomy, and the [quick_faq]
accordion shortcode. Detailed history was not maintained prior to 4.0.0.
## Meta
* Version **4.1.0**
* Zuletzt aktualisiert **vor 3 Monaten**
* Aktive Installationen **90+**
* WordPress-Version ** 6.2 oder höher **
* Getestet bis **7.0.7**
* PHP-Version ** 7.4 oder höher **
* Sprache
* [English (US)](https://wordpress.org/plugins/accordion-faq-plugin/)
* Schlagwörter
* [Accordion](https://de.wordpress.org/plugins/tags/accordion/)[faq](https://de.wordpress.org/plugins/tags/faq/)
[faq block](https://de.wordpress.org/plugins/tags/faq-block/)[faq page](https://de.wordpress.org/plugins/tags/faq-page/)
[faq schema](https://de.wordpress.org/plugins/tags/faq-schema/)
* [Erweiterte Ansicht](https://de.wordpress.org/plugins/accordion-faq-plugin/advanced/)
## Bewertungen
3.3 von 5 Sternen.
* [ 2 5-Sterne-Rezensionen ](https://wordpress.org/support/plugin/accordion-faq-plugin/reviews/?filter=5)
* [ 0 4-Sterne-Rezensionen ](https://wordpress.org/support/plugin/accordion-faq-plugin/reviews/?filter=4)
* [ 0 3-Sterne-Rezensionen ](https://wordpress.org/support/plugin/accordion-faq-plugin/reviews/?filter=3)
* [ 1 2-Sterne-Rezension ](https://wordpress.org/support/plugin/accordion-faq-plugin/reviews/?filter=2)
* [ 1 1-Sterne-Rezension ](https://wordpress.org/support/plugin/accordion-faq-plugin/reviews/?filter=1)
[Deine Rezension](https://wordpress.org/support/plugin/accordion-faq-plugin/reviews/#new-post)
[Alle Rezensionen anzeigen](https://wordpress.org/support/plugin/accordion-faq-plugin/reviews/)
## Mitwirkende
* [ Mahesh Patel ](https://profiles.wordpress.org/maheshpatel/)
## Support
Möchtest du etwas mitteilen? Brauchst du Unterstützung?
[Support-Forum anzeigen](https://wordpress.org/support/plugin/accordion-faq-plugin/)