Faq schema not visible

Moderate effort

Render all FAQ answers in the server-delivered HTML so that both Google and your FAQ structured data can see every question and answer — not just the one currently open in a JavaScript accordion.

What it is

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.

Why it matters

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.

How to fix it

  1. Audit your FAQ section: open your page source (right-click → View Page Source) and search for each FAQ answer text. If answers only appear after clicking, they are JavaScript-rendered and invisible to Google.
  2. Replace or supplement the JavaScript accordion with a native HTML <details>/<summary> element for each FAQ pair, OR ensure your accordion outputs all question/answer pairs in the raw HTML (even if visually collapsed via CSS).
  3. Add or update a FAQPage JSON-LD block in the page <head> that lists every question and its full answer — the text must match what is in the HTML exactly.
  4. Validate the fix using Google's Rich Results Test: paste your URL and confirm all FAQ items are detected with no warnings about missing visible content.
  5. Re-submit the page via Google Search Console (URL Inspection → Request Indexing) so Google recrawls and picks up the corrected markup.
  6. Monitor the 'FAQ rich results' report in Google Search Console (Enhancements section) over the following 2–4 weeks to confirm the rich results appear in search.

Fix it on your platform

Pick your platform for the exact steps.

How to fix faq schema not visible on 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).
Full Shopify guide →Official Shopify docs ↗
How to fix faq schema not visible on WooCommerce
  1. Install a structured-data plugin such as Rank Math SEO or Yoast SEO (with the Schema add-on) — these can inject FAQPage JSON-LD automatically.
  2. Edit the FAQ page in WordPress (Pages → your FAQ page → Edit with Gutenberg).
  3. Add the Rank Math / Yoast FAQ block, which outputs both visible HTML and matching JSON-LD in one step — all answers are in the HTML regardless of accordion state.
  4. If you have an existing JavaScript accordion plugin (e.g. a page-builder widget), remove it and use the native FAQ block instead, or ensure the plugin outputs all answers in the server HTML (check its settings for 'render all panels' or 'disable lazy-load').
  5. Validate with Google's Rich Results Test after publishing.
Full WooCommerce guide →Official WooCommerce docs ↗
How to fix faq schema not visible on BigCommerce
  1. Go to Storefront → Script Manager (or Storefront → My Themes → Edit Theme Files) in your BigCommerce Admin.
  2. Open the Handlebars template for your FAQ page (e.g. templates/pages/page.html or a custom template assigned to that page).
  3. Replace the JavaScript accordion markup with native <details>/<summary> HTML so all answers are in the server-rendered HTML.
  4. Inject the FAQPage JSON-LD script block into the page <head> using Script Manager (set location to 'Head', page target to the FAQ page URL) or hardcode it in the template file.
  5. Publish and validate with the Rich Results Test.
Full BigCommerce guide →Official BigCommerce docs ↗
How to fix faq schema not visible on Wix
  1. Open the Wix Editor for your FAQ page.
  2. If you are using the Wix Accordion / FAQ app widget, check whether it supports 'Expand All' rendering or server-side output — most Wix accordion widgets are JavaScript-rendered. Switch to a plain Text + Collapsible Text element combination, or use the Wix FAQ app which has structured-data support.
  3. To inject FAQPage JSON-LD, go to your site Dashboard → SEO → SEO Settings (or use the Wix SEO Wiz) and add a custom JSON-LD snippet via Settings → Advanced SEO → <head> tags for that specific page.
  4. Alternatively, use a Velo (Wix code) snippet: in the page's code panel (Page Code), add the JSON-LD block to the page <head> via wixWindow or a custom HTML element embedding the <script type='application/ld+json'> block.
  5. Validate with the Rich Results Test.
Full Wix guide →Official Wix docs ↗
How to fix faq schema not visible on Squarespace
  1. In your Squarespace dashboard, go to Pages → your FAQ page → Edit.
  2. If you are using an Accordion block, note that Squarespace Accordion blocks render all panel content in the HTML (they use CSS to show/hide) — confirm by checking page source for the answer text. If it is present, the visibility issue is already resolved.
  3. For FAQ structured data, go to Pages → FAQ page → Page Settings (gear icon) → Advanced → Page Header Code Injection and paste your FAQPage JSON-LD <script> block there.
  4. Ensure every question/answer in the JSON-LD exactly matches the text in the Accordion blocks on the page.
  5. Validate with the Rich Results Test.
Full Squarespace guide →Official Squarespace docs ↗
How to fix faq schema not visible on Webflow
  1. Open the FAQ page in the Webflow Designer.
  2. Check your accordion component: Webflow's native Tabs/Accordion component renders all panel HTML in the DOM (visibility is controlled by CSS classes) — verify by previewing and viewing source. If all answer text is in the source HTML, only the JSON-LD step is needed.
  3. To add FAQPage JSON-LD, go to Page Settings (the gear icon on the page in the Pages panel) → Custom Code → Inside <head> tag, and paste the FAQPage JSON-LD <script> block.
  4. If you use a custom-coded accordion that uses JavaScript to inject answer text, refactor it to render all answers in static HTML and hide/show with CSS only.
  5. Publish and validate with the Rich Results Test.
Full Webflow guide →Official Webflow docs ↗
How to fix faq schema not visible on 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.
Full Adobe Commerce (Magento) guide →Official Adobe Commerce (Magento) docs ↗
How to fix faq schema not visible on WordPress.org
  1. Install Rank Math SEO (free) or Yoast SEO with Schema add-on.
  2. Edit the FAQ page in the Gutenberg editor (Pages → your FAQ page → Edit).
  3. Add an FAQ block (Rank Math FAQ Block or Yoast FAQ Block) — these output all questions and answers as visible HTML AND generate matching FAQPage JSON-LD automatically.
  4. If you are using a page builder (Elementor, Divi, etc.), look for an 'FAQ' or 'Accordion' widget that has a 'FAQ Schema' toggle — enable it. Confirm all answers appear in page source HTML.
  5. Validate with the Rich Results Test after publishing.
Full WordPress.org guide →Official WordPress.org docs ↗
How to fix faq schema not visible on Wix eCommerce
  1. Follow the same steps as Wix above.
  2. For product FAQ sections, add a custom HTML element to the product page and embed both the visible <details>/<summary> HTML and the FAQPage JSON-LD <script> block inside it.
  3. Validate each product FAQ page individually in the Rich Results Test.
Full Wix eCommerce guide →Official Wix eCommerce docs ↗

Does your site have this issue?

Run a free SEOLZ scan to find faq schema not visible — and every other issue — across your whole site in minutes.

Scan my site free

Frequently asked questions

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.

Why does faq schema not visible matter?

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.

How do I fix faq schema not visible?

Render all FAQ answers in the server-delivered HTML so that both Google and your FAQ structured data can see every question and answer — not just the one currently open in a JavaScript accordion.

Authoritative references

Related Answer Engine Optimization issues