How to fix faq schema not visible on Adobe Commerce (Magento)

Steps for Adobe Commerce (Magento)

1. Identify the CMS page or block used for your FAQ (Content → Pages or Content → Blocks in the Admin).
2. Edit the FAQ page HTML: replace any JavaScript accordion widget (e.g. a jQuery UI accordion) with native <details>/<summary> HTML elements so all answers are present in server-rendered HTML.
3. Add the FAQPage JSON-LD block directly inside the page content or, preferably, create a custom layout XML file (e.g. cms_page_view_id_faq.xml) that adds a block injecting the JSON-LD into the <head>.
4. Alternatively, install a structured-data extension (e.g. from Magento Marketplace) that supports FAQPage schema and configure it to match your page content.
5. Clear the full-page cache (System → Cache Management → Flush Magento Cache), then validate with the Rich Results Test.

What is faq schema not visible?

FAQ schema (structured data) is a block of code you add to a page that tells Google exactly which questions and answers appear there. Google's rules require that every question and answer in your schema must also be *visibly present in the page's HTML* — it cannot be hidden inside JavaScript that only renders content after a user clicks. When you use a JavaScript accordion (a "click to expand" FAQ widget), most platforms only put the currently-open answer into the HTML; the rest exist only in JavaScript memory. Google sees the mismatch and ignores — or penalises — your FAQ rich results.

FAQ rich results display your questions directly in Google search listings as expandable dropdowns beneath your page title, dramatically increasing the space your result takes up and lifting click-through rates. Losing those rich results means less visibility, fewer clicks, and missed opportunities to answer buyer questions before they even visit your site. Google explicitly requires that schema content matches what is rendered in the page HTML; a mismatch can also trigger a manual action or cause Google to distrust all structured data on your site. Fixing this is one of the highest-ROI AEO (Answer Engine Optimisation) improvements you can make because it directly influences how AI-powered search features and voice assistants surface your content.

See the complete Faq schema not visible guide for every platform and the full background.