How to fix faq schema not visible on Shopify

Steps for Shopify

1. In your Shopify Admin, go to Online Store → Themes → Actions → Edit code.
2. Open the template file for the page with the FAQ (e.g. templates/page.faq.liquid or sections/faq.liquid).
3. Replace any JavaScript-only accordion with native <details>/<summary> HTML elements — each <details> block contains a <summary> (the question) and a <p> (the answer). All answers are in the HTML at all times.
4. In the same file (or in theme.liquid inside <head>), add a FAQPage JSON-LD <script> block listing every question and answer. Use Liquid loops to generate it dynamically from your metafields or section blocks so it stays in sync.
5. Save, then test the live URL in Google's Rich Results Test (search.google.com/test/rich-results).

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.