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.

MAGENTO VERSIONS 2.4.4 - 2.4.8 (MAGENTO/FRAMEWORK 103.0.X)
PHP 8.1 - 8.2 - 8.3
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.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 & Documentation

Need more help?

Our support team typically responds within 1 business day.

Contact Us