OCMLABS/MODULE-FAQ - No 001

Frequently Asked Questions (FAQ)

A product-page FAQ accordion with built-in FAQPage JSON-LD for Google rich results. WCAG 2.1 AA accessible out of the box. Assign one FAQ to as many products as you want via a searchable admin product grid.

✦Schema built in

Every FAQ block outputs valid FAQPage structured data automatically. No second extension, no manual JSON-LD.

✦Anywhere in the store

PDPs, categories, CMS pages, and landing pages via widget - with per-page question sets managed in admin.

✦Clean architecture

Service contracts, dependency injection, and UI components. Readable PHP your team can extend without fear.

✦Hyva-native

Dedicated Hyva templates (Tailwind + Alpine.js) plus full Luma support. Built by an official Hyva Partner - no compatibility shims.

SEE IT IN ACTION

DEMO - 1:52

Magento FAQ Extension: Product FAQs with FAQPage Schema (Product FAQ by OCM Labs)

PLATFORM MAGENTO OPEN SOURCE - ADOBE COMMERCE
MAGENTO VERSIONS 2.4.6 - 2.4.9 (MAGENTO/FRAMEWORK 103.0.X)
PHP 8.3 - 8.4
THEME SUPPORT HYVA - LUMA - COMPATIBLE OUT OF THE BOX
DELIVERY COMPOSER - PRIVATE PACKAGIST

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.

✦ IN THE STORE & IN THE ADMIN

See it working.

✦ INSTALLATION

Two commands. Like it should be.

YOUR-STORE - TERMINAL
# keys provisioned to your dashboard at purchase
$ composer require ocmlabs/module-faq-hyva
$ bin/magento setup:upgrade

✦ RELEASE LOG

Maintained like production code - because it is.

1.0.8

Fixes

  • On Luma storefronts, clicking or pressing Enter or Space on an FAQ question now reliably opens and closes its answer. Previously the answer could stay open when collapsed, or stay hidden when expanded, and screen readers were told the opposite of what was on screen.

Accessibility

  • On Hyva storefronts, each FAQ question is now a heading and each answer is a labelled region, matching the Luma accordion so screen reader users can jump between questions and hear which question an answer belongs to.
  • On Hyva storefronts, the keyboard focus indicator on FAQ questions is now higher contrast.

1.0.7

Fixes

  • Saving an existing FAQ without expanding the Associated Products section no longer fails with "Please select at least one product." The FAQ keeps its current product assignments.
  • On Hyva storefronts, the FAQ section now uses the FAQ Heading Title text from configuration and respects the Hide Heading setting, matching Luma. When the heading is hidden, the section keeps an accessible name for screen reader users.

1.0.6

Compatibility

  • Magento Open Source and Adobe Commerce 2.4.9 support. The module now installs on 2.4.6 through 2.4.9.
  • Verified on PHP 8.4, the version Magento 2.4.9 requires.

Fixes

  • FAQ structured data now hex-encodes < and > so answer content cannot break out of the script tag.
  • Luma FAQ accordion script now declares its jQuery UI widget dependency explicitly.

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 FAQPage schema 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_FaqHyva module.

Requirements

  • Magento 2.4.6 or later
  • PHP 8.3 or later
OCM Labs guarantee stamp

✦ THE OCM LABS LICENSE

Your code. Your keys.

SOURCE CODEFULL ACCESS, UNENCRYPTED, FOREVER
DELIVERYCOMPOSER · PRIVATE PACKAGIST
AT EXPIRYFROZEN AT YOUR LAST VERSION - NEVER REVOKED
UPDATES12 MONTHS INCLUDED · RENEW WHEN YOU WANT
KILL SWITCHTHERE ISN'T ONE

✦ MODULE QUESTIONS

Before you buy.

No. The module scopes its FAQPage markup to the FAQ block and plays nicely alongside Product schema.

Yes - Hyva and Luma are both supported out of the box, with dedicated Hyva templates.

It keeps working, permanently, at the last version you were entitled to.

Yes - extend via preferences and plugins, or patch it directly.

✦ SUPPORT

Support & Documentation

Need more help?

Our support team typically responds within 1 business day.