Frequently Asked Questions ( FAQ)
Overview
What this module does
A product-page FAQ accordion with automatic FAQPage JSON-LD, managed from the Magento admin. Accessible by default, reusable across products, no theme edits.
A product FAQ tab that ships with FAQPage schema out of the box
OCMLabs Product FAQs drops a clean Q&A accordion into any Magento 2 product page and emits the FAQPage JSON-LD that Google needs for rich results. Write answers once, reuse them across your catalog, and stop losing conversions to unanswered sizing, compatibility, and returns questions.
One FAQ, as many products as you need
Most FAQ tools lock a question to a single product. OCMLabs Product FAQs gives you a searchable product grid right in the admin form. Tick the products a FAQ should appear on, save, done. Update the answer in one place and it updates everywhere the FAQ is assigned.
FAQPage schema, automatic
Every active FAQ writes FAQPage JSON-LD into the product page head. No SEO plugin config, no separate schema module. Tags are stripped from the structured data so rich WYSIWYG answers never break the markup.
WCAG 2.1 AA accessible storefront
The accordion is audited against WCAG 2.1 Level AA: semantic heading buttons for screen-reader navigation, focus outline at 4.8:1 contrast, native keyboard support, and a tab control that always has an accessible name. The compliance pitch is real, not decorative.
Content editors, not developers
FAQs live under Catalog > Product FAQs behind a dedicated ACL (OCMLabs_Faq::manage). Tab label, section heading, and visibility are store-view scoped. A sort field fixes display order; an Active toggle drafts entries without deleting them. If a product has no active FAQs, the tab disappears entirely. No empty shells to clean up.
Screenshots
See the interface before you buy
Storefront accordion, admin FAQ grid, the edit form with its product picker, and the generated JSON-LD as it lands in page source.
Change Log
What changed in recent releases
Version notes and release history for this module.
1.0.5
Maintenance
- Composer package metadata cleanup. No functional changes.
1.0.4
Accessibility
- Storefront FAQ accordion now conforms to WCAG 2.1 Level AA.
- Each FAQ question is a true heading, so screen reader users can jump between FAQs using heading shortcuts.
- Each answer is announced as a labeled region tied to its question.
- Keyboard focus indicator strengthened to meet non-text contrast requirements.
Fixed
- Clearing the FAQ Tab Title field in admin no longer produces an unnamed product tab. The tab now falls back to a default FAQs label, so it remains identifiable to keyboard and screen reader users.
1.0.3
Added
- Module Information panel under Stores > Configuration > OCMLabs > Product FAQs showing the installed version and links to documentation and FAQ management.
1.0.2
Fixed
- Resolved a Composer installation issue on certain environments.
1.0.1
Added
- Adobe Commerce support.
1.0.0
Initial public release.
Features
- Create, edit, and manage FAQs under Catalog > Product FAQs in the Magento admin.
- Assign a single FAQ to any number of products using a searchable product grid.
- FAQ accordion tab on product detail pages with configurable sort order per FAQ.
- Automatic JSON-LD
FAQPageschema output for Google rich result eligibility. - Store-view-scoped display settings: FAQ heading text, tab label, heading visibility, and tab visibility.
- WYSIWYG editor for rich-text answers.
- Permission-controlled admin access via a dedicated ACL resource.
- Active/inactive toggle per FAQ for drafting and temporary removal without deletion.
- Hyva theme support available via the companion
OCMLabs_FaqHyvamodule.
Requirements
- Magento 2.4.6 or later
- PHP 8.3 or later
Support & Documentation
Need more help?
Our support team typically responds within 1 business day.