CatalogFAQ — FAQ Accordion & Product FAQs

By Plugins.shop

0+ active installationsVersion 1.2.11

Create searchable FAQ accordions and WooCommerce product FAQs. Reuse answers with Gutenberg blocks, shortcodes and Elementor widgets.

Description

Write an answer once. Use it wherever customers need it.

CatalogFAQ is a WordPress FAQ plugin for creating FAQ accordions and WooCommerce product FAQs. Keep answers in one library, organize them into reusable groups, and update shared wording in one place.

Reuse delivery, returns, sizing and product-care answers on a help page and relevant products. Add separate groups for questions that apply to particular products.

Free includes everyday FAQ publishing, search and product assignments with no paid question quota. No vendor account, payment or licence key is needed, and Free does not expire. WooCommerce is optional: ordinary WordPress pages work without it.

Try the Free demo | Explore the Pro demo | Get support

The demos use sample data. Free simulates the plugin in your browser; Pro demonstrates workflows with a different interface. Neither is a hosted WordPress admin session.

One FAQ library, reusable answer groups

Create questions and rich-text answers, organize them with topics, and choose which answers belong in each group. Arrange their display order and reuse the same answer in several groups instead of maintaining separate copies. WordPress revisions keep a history of answer edits. Only published groups display their published answers; draft, private, pending and scheduled groups stay hidden while their assignments are retained. Password-protected groups require the visitor to unlock them.

For example, make separate Delivery, Returns and Product Care groups, then use the appropriate groups on each page or product. Shared edits appear on fresh page renders; cached pages may need refreshing.

FAQ accordion, cards or list — with search

Choose a collapsible accordion, cards or an expanded list. Adjust the accent color, spacing, corners and width in the display settings. Optional search filters the questions and answer text as you type, with a Clear search button to restore the full group, helping readers find a relevant answer without scanning every item.

Accordion expand/collapse controls and direct question links are included. Copy a question link when replying to an enquiry so the reader can open the relevant answer. In standard WooCommerce product tabs, the link selects the containing FAQ tab too.

WooCommerce product FAQs

Assign groups to individual products, product categories or product tags. Find products by name or SKU when choosing their assignments. Use shared delivery and returns answers across a category, alongside care instructions that apply to one product.

Display assigned answers in a product FAQ tab or the Catalog Product FAQ block. Classic product tabs and compatible WooCommerce Product Details blocks can already show them; check a published product before adding another placement. Product features require WooCommerce.

Gutenberg blocks, shortcodes and Elementor widgets

Place a reusable group with the CatalogFAQ block in the WordPress block editor (Gutenberg), or copy its generated shortcode into a suitable shortcode area. The product block uses the current product’s assignments in a product template.

Elementor widgets are available when Elementor is active. Elementor is optional; blocks and shortcodes work without it. Group choices respect the editor’s FAQ-management and group-editing permissions.

CSV import, content export and backups

Use the supplied Question, Answer and Group spreadsheet template to import FAQ content, or exchange content through JSON/CSV. Preview the import before applying it; new spreadsheet answers and groups start as drafts so you can review and publish both before placing them.

ZIP backups support same-site restore of CatalogFAQ records and configuration. New backups record original FAQ/group IDs and publication state. Restore reuses available original IDs so existing shortcodes and blocks can reconnect; conflicting IDs are left for review. Older backups lack those IDs and require manual placement repair after records are deleted. Passwords, media files and page content are not included. ZIP tools require PHP zip; JSON/CSV does not. Dependencies are not installed automatically.

When to choose Pro

Free covers creating, reusing and placing answers. The separate paid Pro add-on adds workflows for managing a larger catalogue:

  • Product rules and exceptions: choose answers for matching products and adjust individual product wording or visibility.
  • Store-wide defaults: start with common answers across the store, then refine their placement.
  • Coverage and rule previews: inspect effective answers and review where FAQs are assigned before making changes.
  • Bulk changes and activity records: preview supported changes, apply them across selected records and review their outcomes.
  • Cross-site assignment mapping: remap products and assignments when moving content between sites, including cross-site ZIP imports.

Pro is distributed separately, outside WordPress.org. Compare Free and Pro. Existing Free defaults and in-progress import plans retain the compatibility protections explained below. You can switch off the optional, read-only Pro previews in the Free sidebar.

External services and privacy

Free has no vendor API, telemetry, payment API, remote licence check or external update server. Assets are local; editor libraries come from WordPress. Local REST (catalog-faq/v1, wp/v2) and admin-post.php handle drafts, choices, settings and jobs with authentication/nonces/permissions. WooCommerce, Elementor and cache integrations run locally; no CDN/vendor purge API is called. Other software/hosting has its own behavior.

Optional media you choose

External URLs can make WordPress oEmbed contact the host/discovered provider during editing, preview or rendering, even for drafts and failed/filtered embeds. Requests expose the media URL, server IP and HTTP user agent. Do not include secrets or private signed URLs.

Remote players/images/audio/video contact their host from visitors’ browsers, exposing resource URL, IP, browser information and permitted referrer/cookies. Provider cookies/analytics are separate. No media-consent banner or click-to-load blocker is included; use local media/ordinary links or configure consent before publishing remote media.

The renderer permits supported HTTPS embed-player paths on the exact hosts below. Raw iframe markup requires an authorized WordPress save path; imports, quick edits and bulk/local answer changes still sanitize it. This is not permission to embed arbitrary pages from these providers:

oEmbed discovery, chosen media and site extensions can contact other hosts: this allowlist filters output only. Review each provider’s terms/privacy. Local FAQs need no provider key.

Stored data and removal

CatalogFAQ itself does not collect visitor analytics, read orders/customer records or send site data to its vendor. WordPress stores content/revisions, groups, topics, assignments, settings, user preferences and private import/index/job records (including actor IDs, origins, mappings and before/after content). Protect exports; they do not include all operational personal data.

Finished journals become cleanup candidates after 90 days by default and after their revert window. Jobs/plans/content can remain; bounded scheduled cleanup does not guarantee deletion at expiry.

Deactivation/default uninstall preserve data. Optional deletion under Import / export removes the listed Free content/configuration and shared jobs, saved setup answers, notices/help preferences, product fingerprints, database locks/temporary records and CatalogFAQ capabilities from all roles. It keeps unrelated user metadata, source-plugin records, pages, products, backups and Pro settings. Uninstall stops Free’s scheduled tasks. Failed cleanup reports an error and retains the deletion preference for retry; earlier deletions are not rolled back.

On multisite, uninstall checks every site and deletes data only where its administrator enabled cleanup. New setup/help state is site-specific. Older unscoped network setup/help records cannot safely be assigned to one site: they are retained unless every site enables deletion. After updating, network setup progress starts separately on each site; existing FAQs and groups remain. Temporary entries held only in an external object cache may remain until their original expiry (up to two hours); uninstall does not flush unrelated caches.

More Plugins uses a local collection, no catalogue/telemetry requests or automatic installs; links open Plugins.shop. Pro examples are fictional/read-only. The preview switch is stored per user/site, removed by optional cleanup. Focus/navigation use optional session storage.

Review reminders store the first qualifying-use timestamp, up to three usage dates, your preference and an optional postponement deadline in WordPress user metadata, separately for each user and site. Only local administrative use with published FAQs counts; visitor activity is not recorded. Dismissing reminders or choosing Write a review stops collecting usage dates. Free and Pro share the same preference, which survives updates and ordinary deactivation/uninstall. WordPress personal-data export/erasure includes this reminder record; opted-in Free uninstall removes it for the selected site. Erasing the record resets the preference, so later qualifying use can start a new waiting period. No reminder data is sent to the publisher. WordPress.org is contacted by your browser only when you choose the review link and requires its own account.

Useful alongside CatalogFAQ

CatalogFAQ is made by Plugins.shop. These optional plugins work independently and are available on WordPress.org:

Installation

  1. In Plugins > Add New, search for CatalogFAQ — FAQ Accordion & Product FAQs, then install and activate it. You can also use Upload Plugin with the downloaded ZIP.
  2. Open CatalogFAQ > Start here. Name a group, write your first question and answer, then save the published FAQ to continue.
  3. Add a CatalogFAQ block to a page and select the group, or copy the group’s generated shortcode. Publish the page and check it while signed out.
  4. Add more answers in FAQ library. Use Groups to select their membership and display order.
  5. For WooCommerce, assign groups to products, categories or tags. Check a published product first: classic tabs and compatible WooCommerce Product Details blocks can already show the FAQs. If they are missing, add the Catalog Product FAQ block to the Single Product template. Use one placement to avoid duplicates.

Updating and older-folder migration

Back up first and ensure WordPress 6.7 or newer is installed. Replace Free files without uninstalling. If you use Pro, review its deactivation impact, deactivate it, update Free to 1.2.11, then replace and reactivate the matching Pro 1.2.11. Update both editions before switching PHP versions. Existing FAQs, assignments, settings and original revert deadlines remain; core API 2 is unchanged.

For Catalog FAQ 0.2.4 or earlier, test on staging. Deactivate Pro, then old Free; do not use Delete. Install/activate this plugin, then replace/reactivate compatible Pro. Saved identifiers/content are reused. The new catalogfaq-product-answers folder does not replace catalog-faq automatically; old Free must be inactive. After verification, remove the inactive old folder by SFTP/file manager without running its uninstaller. Pro revert deadlines continue. The downloaded plugin includes detailed migration steps in docs/technical-reference.txt.

FAQ

Which WordPress and PHP versions do I need?

Free and Pro 1.2.11 require WordPress 6.7 or newer and PHP 7.4 or newer. PHP 7.4 is the compatibility minimum; use a currently maintained PHP version for your website. Optional WooCommerce and Elementor integrations also need versions compatible with your WordPress and PHP installation. These dependencies are not installed automatically.

Can I create a WordPress FAQ page without WooCommerce?

Yes. Create your questions and groups, then add a CatalogFAQ block or generated shortcode to a page. Only product assignments and product FAQ features require WooCommerce.

Can I reuse the same answer on several pages and products?

Yes. Groups reference shared answers rather than making separate copies. An answer can belong to more than one group. Editing it updates fresh renders of every placement that uses it; refresh page caches if old wording remains.

Why did an imported group stop displaying after updating?

Earlier releases displayed draft and private groups. Version 1.2.11 honors those visibility choices. Open Groups, edit the affected group, and review its answers. For content intended for visitors, choose Public visibility and publish/update the group. Keep private material unpublished; saved assignments are retained.

Are there limits on the number of questions in Free?

Free has no paid question quota or expiry. Internal request and import limits keep operations manageable; they are not upgrade quotas. Large collections may require multiple pages or batches.

Which layouts, search tools and question links are included?

Free includes accordion, cards and list layouts, with settings for color, spacing, corners and width. Accordion controls let readers expand or collapse the displayed answers. Optional search filters the question and answer text currently displayed in that FAQ instance; it is not a site-wide search engine. Enable question links and use Copy link beside an answer to share its location on a published page your recipient can access.

Can I use Gutenberg, shortcodes or Elementor?

Yes. Use the CatalogFAQ block to select a reusable group in the WordPress block editor, or copy the group’s generated shortcode into a Shortcode block or another supported shortcode area. The Catalog Product FAQ block needs product context, such as a Single Product template.

Optional Elementor widgets are available when Elementor is active. Group choices are available only to FAQ managers with permission to edit each group; saved public widgets continue to render for visitors. Elementor is not required for blocks or shortcodes.

Can I assign FAQs to WooCommerce categories and tags?

Yes. Free supports direct product, product-category and product-tag assignments. Use the product picker to search by name or SKU. New store-wide defaults, conditional product rules and product-specific exceptions are Pro workflows.

Why aren’t my product FAQs showing?

Check that both the group and its answers are published, then check saved membership and product assignments. Draft/private groups, including groups created by older imports, stay hidden until deliberately published. Classic tabs and compatible WooCommerce Product Details blocks may show assigned FAQs automatically. If they are missing, add the Catalog Product FAQ block to the Single Product template; avoid adding a second placement when FAQs already appear. Check the product while signed out and refresh caches. WooCommerce’s Coming soon setting can prevent visitors from reaching product pages.

Can I preview FAQs on an unpublished or password-protected product?

Yes, when WordPress permits you to read and edit that unpublished product. Private products require read permission. A password-protected product must be unlocked first, including for administrators. Only published, non-password-protected FAQ answers are shown.

Can I include formatted answers, images or video?

Answers support rich content, subject to the plugin’s rendering rules. Prefer a supported video URL or WordPress Embed block. Raw supported iframe markup can render when an authorized editor has saved it, but WordPress save permissions still apply. Quick editing, imports and bulk/local answer changes sanitize HTML and are not a lossless raw-iframe editing workflow. Unsupported answer blocks are retained/reported but not rendered. Dynamic bindings do not run; check saved fallback text in the preview. Remote media can contact external providers during editing, preview and display, including unpublished previews; see External services and privacy before adding it.

Can I import FAQ questions from a spreadsheet?

Yes. Download the Question, Answer and Group CSV template from Import / export, then preview the import. New spreadsheet FAQs and groups are drafts; publish both after review. Matching rows update only when explicitly selected. Review protected/scheduled content and unresolved references. Free also imports FAQ content from another site through JSON/CSV; cross-site assignment mapping and product remapping require Pro.

Can I migrate from Easy Accordion?

Free reads Easy Accordion FREE 3.1.10 classic custom-content accordions without changing the source records or rewriting existing shortcodes. Other sources and shortcode placements need manual work. Back up first and review imported content before publishing it.

Does a ZIP export back up my whole website?

No. ZIP backups contain CatalogFAQ records and configuration, not media files, page content, passwords or a complete WordPress backup. Backups made from 1.2.11 record original IDs. On the same site, a reviewed ZIP restore can reuse those IDs only while they remain available; conflicts are not overwritten. Published, draft, pending and private group states are preserved. Protected or scheduled content is held as draft for review.

Backups made with 1.2.10 or earlier cannot reconstruct deleted original IDs: replace affected shortcode/block selections manually after import. Legacy groups with no saved status also need publication review. JSON/CSV matches UUIDs for content exchange; it does not restore deleted placement IDs. Cross-site ZIP import requires Pro. ZIP tools need PHP zip; JSON/CSV does not.

Why does a page still show an older answer after saving?

Page caches can serve an older render after a shared answer changes. Use Display & help > Page cache for status/retry. Tested integrations: WP Super Cache 3.1.4 and W3 Total Cache 2.10.7 local disk caches. Handle host/CDN/browser/multisite caches separately. Page purges do not flush object caches; failed transactions may clear them to discard rolled-back values.

What stays in Free when I update?

Existing Free store-wide defaults retain editing access, and in-progress Free bundle import plans remain resumable. New store-wide defaults, cross-site assignment mapping, product remapping and cross-site ZIP imports require Pro. Free still imports cross-site FAQ content through JSON/CSV.

What happens when I disable Pro?

Free content/assignments remain. Pro rules/exceptions stop: hidden questions can return, local wording becomes shared wording, and rule-only answers can disappear. Review the deactivation comparison first. Bulk work pauses; reverting needs compatible Pro within the original 30-day window, which reactivation does not reset.

Can I hide the Pro previews in the sidebar?

Yes. Turn off the Pro previews switch to hide the optional preview destinations. They are fictional, read-only examples; switching them on does not activate Pro features or start a trial.

Does CatalogFAQ add FAQ schema or generate answers with AI?

No. This release publishes answers you write. It does not output FAQPage schema or generate answers with AI, and makes no promises about search rankings, rich results, traffic or revenue.

Can I turn off review reminders?

Yes. Choose Don’t ask again on the FAQ library reminder, or manage your preference under Display & help. You can also postpone it for 30 days. The reminder waits at least 30 days from your first qualifying use and use on three separate days with published FAQs. Existing installations start that waiting period on their next qualifying visit after updating. The permanent WordPress.org review link remains available in Display & help. All feedback is welcome; choosing the link stops reminders without claiming that you submitted a review.

Screenshots

Changelog

1.2.11

  • Honor group publication and password protection in every FAQ placement while retaining saved assignments. Show status and record IDs in group choices.
  • Record original IDs and group publication in new ZIP backups. Same-site restores reuse available original IDs; conflicts and older backups receive explicit placement warnings instead of silently changing IDs.
  • Keep imported spreadsheet groups as drafts until reviewed and published; skip harmless empty default-assignment records.
  • Preserve supported HTTPS video-player iframes through the renderer without changing WordPress author permissions or allowing arbitrary frames.
  • Avoid product capability notices when WooCommerce is inactive and explain the dependency on saved Product FAQs links.
  • Explain when Easy Accordion content is absent and prevent empty migration jobs.

1.2.10

  • Add a permanent WordPress.org review link and reminder preferences under Display & help.
  • Show a neutral, optional FAQ library reminder only after 30 days and use on three separate days with published FAQs. Postpone it for 30 days or turn it off for your account on that site.
  • Keep reminder dates and preferences local, shared by Free and Pro, with WordPress personal-data export/erasure and opted-in uninstall cleanup.
  • Protect preference changes with permissions, an independent nonce and stale-form checks.

1.2.9

  • Support PHP 7.4 with WordPress 6.7 or newer. Align Free and Pro on the same tested minimums while retaining core API 2.
  • Replace PHP 8-only syntax without changing FAQ publishing, permissions or validation.
  • Reject malformed UTF-8 CSV input without triggering encoding notices on older WordPress versions.
  • Skip temporarily unavailable product records when WooCommerce is inactive, preserving their assignments for reactivation.

1.2.8

  • Open the containing WooCommerce product tab when following a direct question link, including after tab initialization. Keep the question link and existing tab controls intact.
  • Explain that FAQ search filters as you type and add a keyboard-accessible Clear search button. Clearing restores the previous accordion state.
  • Handle browser search clearing, immediate Enter searches and composed text input without submitting a surrounding form.

1.2.7

  • Correct the plugin author metadata to pluginsshop. Feature behavior is unchanged.

1.2.6

  • Remove saved setup answers, notices, help preferences, product fingerprints, database locks and temporary database records during opted-in uninstall. Remove CatalogFAQ capabilities from every role.
  • Stop with a retry error if deletion of owned revisions or metadata is blocked; keep the parent record available for cleanup.
  • Respect each site’s deletion choice on multisite and keep new setup/help state separate by site. Legacy shared network records are removed only when every site opts in.
  • Restrict Elementor group choices to FAQ managers who can edit each group, while preserving saved public widgets.
  • Show published FAQ answers on authorized product previews and password-unlocked products. Keep restricted products and unpublished or password-protected FAQ answers hidden.

1.2.5

  • Show one save confirmation with cache feedback for the same completed change; preserve errors and confirmations when cache feedback is unavailable.
  • Present saved setup progress as a review step without repeating a new-save message.
  • Use the choices already rendered by WordPress when a picker opens, avoiding a duplicate loading request. Search and pagination still request current results.

1.2.4

  • Refresh caches silently during plugin activation and deactivation; reserve the saved-change notice for actual content changes.
  • Correct product-template guidance: compatible WooCommerce Product Details blocks can already display assigned FAQs. Check the product before adding a separate FAQ block.

1.2.3

  • Separate the sidebar form’s nonce field from WordPress’s editor field to fix editor lock release; refresh the directory listing.
  • Clarify the product picker result count and CSV review instructions and target labels.

The downloaded plugin includes the full history in changelog.txt. Readable GPLv2-or-later source is included; no build is needed. See LICENSE.txt.