About the plugin

AHA Product FAQ is a WooCommerce add-on that lets you add frequently asked questions to each product. You can use global FAQs (reusable questions stored in a custom post type; one question can belong to several categories) and/or product-specific FAQs in a metabox. The product metabox uses a single rich-text editor: click Insert FAQ to expand a panel, type question and answer, then add the item to an accordion list; edit or remove items before saving the product. On each product you can select one or more global FAQ categories (checkboxes); those questions are shown first on the frontend, followed by the product’s own FAQs. Display with the shortcode [aha_product_faq] or automatically on the single product page. Four frontend layout styles, full appearance controls, and optional FAQPage JSON-LD schema.

Features: Global FAQs (CPT + taxonomy; one question in multiple categories); product metabox with single editor and accordion list (Insert FAQ, Edit, Remove); global category checkboxes per product (questions from selected categories shown first); shortcode with optional product_id; automatic display (after summary, after add to cart, or inside product tabs); four layout styles (Accordion, Cards, Bordered, Minimal); appearance and typography controls; optional FAQPage schema. Pro-only; license activation required.

Installation

Via WordPress admin

1. Upload the plugin ZIP via Plugins → Add new → Upload plugin, or install from your preferred source.
2. Click Install now, then Activate.
3. Ensure WooCommerce is installed and active.

Via FTP

1. Unzip the plugin ZIP file on your computer.
2. Connect to your server via FTP and go to wp-content/plugins.
3. Upload the plugin folder (e.g. aha-product-faq) into wp-content/plugins.
4. In the WordPress admin, go to Plugins and activate AHA Product FAQ.

Configuration (tabs)

After activating the plugin, go to WooCommerce → Aha Product FAQ. Settings are organized in tabs: General, Global FAQ, Shortcode, Appearance, and License. The plugin works fully only after a valid license is activated in the License tab.

General

• Enable automatic FAQ – When enabled, the FAQ block is output automatically on the single product page (according to the hook position).
• Hook position – Where to display the FAQ: After product summary, After add to cart, or Inside product tabs.
• FAQ title – Heading shown above the FAQ list (e.g. “Frequently Asked Questions”).
• FAQ schema (JSON-LD) – When enabled, outputs FAQPage structured data for search engines.
• Accordion initial state – Controls how FAQ items appear on page load: All closed (default), First item open, or All open.
• FAQ layout – Choose the visual style for the FAQ list:
  • Accordion – Single continuous list with outer border and +/− icons.
  • Cards – Each question in a separate rounded, spaced box with shadow.
  • Bordered – Left accent border with chevron icon per item; no outer container.
  • Minimal – Full-color question rows separated by lines; no container border, no icon.

Global FAQ

This tab links you to manage Global FAQs (reusable questions) and FAQ Categories. Global questions are stored in a custom post type under the Global FAQs menu (own top-level item in the admin): each post is one question (title) and answer (content). Assign one or more FAQ Categories to each question via the checkboxes in the sidebar; the same question can appear in several categories. Then, on each product’s FAQ metabox, select which categories to show (checkboxes); those questions are displayed first on the frontend, followed by the product’s own FAQs. Duplicate questions (e.g. in two selected categories) are shown only once.

Shortcode

This tab explains how to use the shortcode in pages, posts, and page builders (Elementor, Gutenberg, etc.). Use [aha_product_faq] for the current product or [aha_product_faq product_id="123"] for a specific product. Replace 123 with the product ID.

Appearance

Customize the visual style of the FAQ block on the frontend.

Colors: Choose a Quick palette (Default, Dark, Light, Purple, Blue, Green, Yellow, Orange, Red, Pink, Violet) to fill all color fields at once, or set each color individually: question button background, question text & icon color, hover background, answer area background, answer text color, FAQ section title color, and borders.

Typography:

• Question font size – Preset sizes: Small (0.875rem), Normal (1rem), Medium (1.1rem), Large (1.25rem), Extra Large (1.4rem), 2X Large (1.6rem). Leave as Default to inherit the theme size.
• Question font weight – Normal (400), Medium (500), Semi Bold (600), Bold (700), Extra Bold (800), or Default to inherit from the theme.
• Answer font size – Enter any valid CSS value (e.g. 1rem, 16px, 0.95em). Leave blank to use the theme default.
• Answer font weight – Same presets as question weight above.

License

Paste the license key you received after purchase and click Validate license. When the status shows active, the plugin is fully unlocked (metabox, shortcode, automatic display, and settings). Without a valid license, only the settings page and license tab are available.

Global FAQs

Global FAQs are reusable questions you can attach to multiple categories and then show on many products without retyping.

• Global FAQs (admin menu) – List of questions. Each post: title = question, content = answer (rich text). Use FAQ Categories in the sidebar (checkboxes) to assign one or more categories to each question.
• Global FAQs → FAQ Categories (or the taxonomy in the sidebar when editing a question) – Create and manage categories (e.g. General, Support, License). A question can belong to several categories.
• On each product, in the Product FAQ metabox, use the Global FAQ categories checkboxes to choose which categories to display for that product. Their questions appear first on the frontend, then the product’s own FAQs. Questions that appear in more than one selected category are shown only once.

Product FAQ metabox

On the product edit screen, the Product FAQ metabox lets you add and edit product-specific questions and answers using a single rich-text editor, so the page stays stable.

• Global FAQ categories (if you have any) – Checkboxes to select one or more categories. Their questions are shown first on the frontend.
• Insert FAQ – Click to expand a panel with a question field and a rich-text answer editor. Type the question and answer, then click Insert to add the item to the list below. Items are not saved until you click Update or Publish on the product.
• Product FAQs list – Accordion: each item shows the question; click to expand and see the answer. Use Edit to load that item back into the panel and change it, then click Update. Use Remove to delete the item from the list.

Allowed HTML in answers: paragraphs, bold, italic, links, lists, headings (e.g. h2, h3, h4), blockquote, span, div. No need to write HTML by hand – use the editor.

Shortcode

Use the shortcode to display product FAQs anywhere: pages, posts, or page builders (Elementor, Gutenberg, WPBakery, etc.). All appearance settings can be overridden per shortcode — useful for landing pages with a completely different style.

Basic examples

Replace 123 with the actual product ID. Find it in the product edit URL (post=123) or in the product list.

All available attributes

Any attribute below overrides the global plugin setting for that specific shortcode instance. Leave it out to use the plugin setting instead.

Examples with attributes

In page builders

• Elementor – Add a Shortcode widget and paste the shortcode with any attributes.
• Gutenberg – Add the Shortcode block and paste the shortcode.
• Classic editor – Paste the shortcode directly in the content.

The shortcode only outputs content when the plugin license is active.

Activating the license (Pro)

AHA Product FAQ is a Pro-only plugin. To use the metabox, shortcode, and automatic FAQ display:

1. Install and activate the plugin (WooCommerce must be active).
2. Go to WooCommerce → Aha Product FAQ and open the License tab.
3. Paste the license key you received after purchase and click Validate license.
4. When the status shows Active, the full plugin is unlocked. You can then add FAQs in the product metabox, use the shortcode, and enable automatic display in the General tab.

Video – Setup and demo

Video walkthrough for license activation, configuration, and plugin demonstration.