FAQ Module for Magento 2 with FAQPage Schema

Advanced FAQ extension for Magento 2 with FAQ categories, multi-level assignment to products, catalog categories, and CMS pages, accordion UI, AJAX live search, helpful voting, view-count tracking, FAQ widget, and automatic FAQPage JSON-LD structured data for Google rich results. Fully compatible with Hyva (Alpine.js) and Luma (vanilla JS) storefronts on Magento 2.4.4 — 2.4.8.

Panth FAQ turns your Magento 2 store into a self-service knowledge base. Merchants create FAQ items organized into categories, then assign them granularly — a global FAQ page, a product-specific FAQ on a PDP, a category-specific FAQ on a catalog listing, or a targeted FAQ embedded in any CMS page via widget. Every FAQ page outputs valid FAQPage schema markup so Google can surface your answers directly in search results as rich snippets. The frontend uses a smooth accordion UI with AJAX search that filters questions as shoppers type, reducing support tickets and improving conversion. Built on Panth Core, compatible with Hyva and Luma.

A full walkthrough — storefront FAQ page, category filter, AJAX search, per-category listing, FAQ detail page, admin grids, edit forms and store configuration.

Get a free quote for your project in 24 hours — custom modules, Hyva themes, performance optimization, M1→M2 migrations, and Adobe Commerce Cloud.

Visit our website: kishansavaliya.com  |  Get a quote: kishansavaliya.com/get-quote

• Live Demo
• Why Panth FAQ
• Key Features
• Compatibility
• Installation
• Configuration
• Admin Management
• Screenshots
• FAQPage Schema (SEO)
• FAQ Widget
• FAQ
• Support
• About Panth Infotech
• Quick Links

Most Magento FAQ extensions stop at a single FAQ page. Shoppers land on a product detail page, have a question, leave to find the global FAQ page, search, and often abandon the cart. Panth FAQ eliminates that round trip:

1. Multi-level assignment — the same FAQ item can appear on a product page, a category page, a CMS page, and the global FAQ page — assign once, reuse everywhere.
2. FAQPage JSON-LD — every FAQ page (global, product, category, CMS) automatically ships Google-valid FAQPage structured data so your answers appear as rich results.
3. AJAX live search — large FAQ sets (hundreds of items) stay browsable without page reloads.
4. Hyva + Luma — native Alpine.js accordion for Hyva stores, vanilla-JS accordion for Luma — no jQuery bloat on Hyva.

Content Management

• FAQ Categories — organize questions into categories with optional descriptions, category images, and sort order
• FAQ Items — rich-text answers via Magento's WYSIWYG editor (TinyMCE / Page Builder)
• Multi-level assignment — assign FAQ items to products, catalog categories, and CMS pages directly from the FAQ item edit form using native Magento grids
• Sort order — granular control over question ordering per category and per assignment context

Frontend Display

• Accordion UI — smooth collapse/expand on click; optional default-open first item
• Product page FAQs — display product-relevant FAQs as a tab on the PDP or below the product description
• Category page FAQs — show category-scoped FAQs on catalog listing pages
• CMS page FAQs — embed FAQs on any CMS page via widget or shortcode
• FAQ widget — drop FAQ blocks into any Magento container via the Widget system
• Live client-side search — debounced real-time filtering of visible FAQs
• AJAX server-side search — dedicated endpoint for stores with hundreds of FAQs
• Helpful voting — visitors rate each FAQ as helpful / not helpful (with AJAX submit)
• View-count tracking — popularity metrics per FAQ item

SEO & Structured Data

• FAQPage JSON-LD schema — automatic structured data output on every FAQ page for Google rich results
• SEO-friendly URL rewrites — clean URLs per FAQ category and FAQ item
• Meta title, description, keywords — per-FAQ-item SEO fields
• Canonical URLs — prevent duplicate-content issues across multi-level assignment

Developer Experience

• Hyva compatible — Alpine.js templates, no jQuery, passes Hyva's fallback rules
• Luma compatible — KnockoutJS-free vanilla JS accordion
• Custom CSS field — inject admin-configured CSS without a theme override
• MEQP compliant — passes Adobe's Magento Extension Quality Program
• Panth_Core integration — uses shared theme detection and admin foundation

Tested on:

• Magento 2.4.8-p4 with PHP 8.4 + Hyva 1.3
• Magento 2.4.7 with PHP 8.3 + Luma
• Magento 2.4.6 with PHP 8.2

Composer Installation (Recommended)

composer require mage2kishan/module-faq
bin/magento module:enable Panth_Faq
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Manual Installation via ZIP

1. Download the latest release ZIP from Packagist or the Adobe Commerce Marketplace
2. Extract to app/code/Panth/Faq/ in your Magento installation
3. Run the same commands as above starting from bin/magento module:enable Panth_Faq

Verify Installation

bin/magento module:status Panth_Faq
# Expected output: Module is enabled

After installation, navigate to:

Admin → Stores → Configuration → Panth Extensions → FAQ Settings
Admin → Panth Infotech → FAQ → FAQ Items
Admin → Panth Infotech → FAQ → FAQ Categories

Navigate to Stores → Configuration → Panth Extensions → FAQ Settings.

• FAQ Items — Panth Infotech → FAQ → FAQ Items — create, edit, mass-delete, mass-enable/disable, mass show/hide from the global FAQ page
• FAQ Categories — Panth Infotech → FAQ → FAQ Categories — manage categories with names, descriptions, images, and sort order
• Assignment grids — assign FAQ items to specific products, catalog categories, and CMS pages from the FAQ item edit form using native Magento UI component grids with filters and checkboxes

Storefront

Global FAQ page — accordion UI, category filter tabs, live search bar, helpful-vote buttons, and FAQPage JSON-LD schema.	Category filter — Orders & Shipping — one-click filtering restricts the listing to the selected FAQ category without a page reload.
Category filter — Products & Sizing — each filter chip preserves the search state and page scroll.	AJAX live search — debounced keyword search across question & answer fields; result count is displayed instantly.
Category landing page — SEO-friendly URL (/faq/orders-shipping), category description, and scoped search for large FAQ sets.	FAQ detail page — individual question URL for deep-linking and rich results; thumbs-up / thumbs-down helpful voting.

Admin

FAQ Items grid — native Magento UI component grid with inline filters, mass actions, per-column sort, views and helpful-vote counters.	FAQ Categories grid — manage categories, URL keys, sort order and status from a single screen.
Edit FAQ Item — store-view scoping, WYSIWYG / Page Builder answer, SEO fields, plus multi-level assignment grids for products, catalog categories and CMS pages.	Edit FAQ Category — rich-text description, sort order, and per-category meta title, meta description and meta keywords.
Store Configuration — FAQ Settings — General, Display, Page Integration, SEO and Custom Styling groups, all store-view scoped.

Panth FAQ outputs valid Google FAQPage structured data as JSON-LD on every FAQ page:

{
 "@context": "https://schema.org",
 "@type": "FAQPage",
 "mainEntity": [
 {
 "@type": "Question",
 "name": "How long does shipping take?",
 "acceptedAnswer": {
 "@type": "Answer",
 "text": "Standard shipping takes 3-5 business days..."
 }
 }
 ]
}

This enables rich results in Google Search, significantly improving CTR. Schema emission can be toggled per store scope.

Drop FAQ blocks into any Magento container via Content → Widgets:

1. Create new widget → select Panth FAQ — FAQ Block
2. Configure: select FAQ category, max items, enable search
3. Assign to CMS page, CMS block, or layout container

Does Panth FAQ work with Hyva themes?

Yes. Hyva templates ship as Alpine.js components with no jQuery dependency — they load in the Hyva fallback chain automatically when Hyva_Theme is enabled. Panth_Core's theme detection handles the switch.

Does the FAQPage schema work on product pages?

Yes. When you assign FAQs to a product and enable "Show on Product Pages", the product's FAQ block emits its own FAQPage JSON-LD in addition to the product's own Product schema. Both coexist per Google's guidelines.

Can the same FAQ item appear on multiple products?

Yes. Multi-level assignment is many-to-many — one FAQ item can be assigned to unlimited products, categories, and CMS pages simultaneously. Edit once, update everywhere.

Does AJAX search work with a large FAQ set?

Yes. AJAX search is designed for stores with hundreds of FAQs — the server-side endpoint queries a MySQL FULLTEXT index and returns results in under 100 ms.

Does Panth FAQ support multi-store and multi-language?

Yes. All FAQ items and categories are assigned to store views, and all user-facing strings use Magento's __() translation function. Custom translations can be added via standard i18n CSV files.

Will the helpful voting create a spam vector?

No. Votes are throttled per session / IP, and the endpoint is CSRF-protected. Vote counts are displayed but votes themselves are not public.

Can I disable schema markup?

Yes. Toggle "Enable FAQPage JSON-LD" under SEO configuration. Useful if another SEO extension already emits schema and you want to avoid duplication.

Does it conflict with other FAQ extensions?

No direct conflicts. Panth FAQ uses its own Panth\Faq namespace, its own database tables, and its own routes. If you migrate from another FAQ extension, contact support for migration assistance.

Response time: 1-2 business days.

Need Custom Magento Development?

Commercial — see LICENSE.txt. Distribution is restricted to the Adobe Commerce Marketplace and authorized channels.

Built and maintained by Kishan Savaliya — kishansavaliya.com — a Top Rated Plus Magento developer on Upwork with 10+ years of eCommerce experience.

Panth Infotech is a Magento 2 development agency specializing in high-quality, security-focused extensions and themes for both Hyva and Luma storefronts. Our extension suite covers SEO, performance, checkout, product presentation, customer engagement, and store management — over 34 modules built to MEQP standards and tested across Magento 2.4.4 to 2.4.8.

Browse the full extension catalog on the Adobe Commerce Marketplace or Packagist.

• Website: kishansavaliya.com
• Get a Quote: kishansavaliya.com/get-quote
• Upwork Profile (Top Rated Plus): upwork.com/freelancers/~016dd1767321100e21
• Upwork Agency: upwork.com/agencies/1881421506131960778
• Packagist: packagist.org/packages/mage2kishan/module-faq
• GitHub: github.com/mage2sk/module-faq
• Adobe Marketplace: commercemarketplace.adobe.com
• Email: kishansavaliyakb@gmail.com
• WhatsApp: +91 84012 70422

Ready to upgrade your Magento 2 store?

SEO Keywords: magento 2 faq module, magento 2 faq extension, faq schema, faqpage structured data, faqpage json-ld, accordion faq magento, magento 2 knowledge base, magento 2 faq hyva, magento 2 faq luma, ajax faq search magento, multi-level faq assignment, product page faq magento, category page faq, cms page faq widget, faq rich results google, faq helpful voting magento, magento 2 faq seo, panth faq, panth infotech faq, magento 2.4.8 faq, php 8.4 faq extension, magento 2 self service knowledge base, mage2kishan, mage2sk, hire magento developer upwork, top rated plus magento freelancer, kishan savaliya magento, custom magento development, magento 2 hyva development, magento 2 luma customization