How to fix missing schema faqpage on Adobe Commerce (Magento)

Add FAQPage schema markup to any page that contains a Frequently Asked Questions section so Google can display your answers as rich results directly in search.

Steps for Adobe Commerce (Magento)

  1. In your Admin Panel, go to Content → Pages (or the relevant CMS page containing your FAQ).
  2. Open the page, switch the content editor to HTML mode, and paste the JSON-LD <script> block at the top of the HTML content — OR create a new Static Block (Content → Blocks) containing just the script and reference it in the page layout.
  3. For theme-level integration: add the script to the relevant .phtml template file under app/design/frontend/[Vendor]/[theme]/Magento_Cms/templates/ or the specific product/category template.
  4. Alternatively, install a schema markup extension from the Adobe Commerce Marketplace (search 'FAQ schema' or 'structured data') for a no-code approach.
  5. Flush the cache (System → Cache Management → Flush Magento Cache) after saving, then validate with Google's Rich Results Test.
Official Adobe Commerce (Magento) documentation ↗

What is missing schema faqpage?

FAQPage schema is a small block of structured data (hidden code) you add to a webpage that tells Google "this page contains questions and answers." It uses a standardized vocabulary (Schema.org) so search engines can reliably read and understand your FAQ content — even if it looks different from other sites. The markup lives in a `<script>` tag in the page's HTML and is invisible to shoppers but fully readable by search crawlers.

When Google recognizes valid FAQPage markup, it can expand your search listing to show individual questions and answers directly below your blue link — sometimes doubling or tripling the vertical space your result occupies on the results page. This "rich result" appearance dramatically increases click-through rates because shoppers see your answers before they even visit your site, building trust instantly. For ecommerce stores, FAQ sections on product, shipping, or returns pages are prime candidates: a richer listing means more qualified clicks, lower bounce rates, and more conversions. Without the markup, Google may never discover your FAQ content exists, and a competitor who has the markup can capture that expanded real estate instead of you.

See the complete Missing schema faqpage guide for every platform and the full background.

Not sure if your Adobe Commerce (Magento) store has this?

Run a free SEOLZ scan — we’ll find missing schema faqpage and every other issue across your whole site.

Scan my site free

Fix missing schema faqpage on another platform