FAQ Module for Magento 2 with FAQPage Schema

What you get

Live Demo

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

Key Features

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

Admin Management

• 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

FAQPage Schema (SEO)

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.

FAQ Widget

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

Quick Links

• 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

Compatibility

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

Installation

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

Configuration

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

License

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