Playbook · Shopify product FAQ / accordion missing on PDP
Shopify product FAQ missing on PDP.
Written for a Shopify DTC owner whose product FAQ / accordion never appears on the product page — empty product metafields or metaobjects, theme FAQ sections removed from product.json, FAQ apps off on Current, or FAQPage schema wired for Google while buyers still see no accordion. DIY-first: prove metafields vs theme sections vs FAQ apps vs schema; repair the live PDP path; retest on the live storefront. Distinct from product description tabs / accordion missing, product reviews / star ratings missing, size chart / fit guide missing, and product recommendations / recently viewed carousels. No earnings claims, no invented case studies.
Nico at Latch AI Ops · Sep 8, 2026 · ~12 minute read
Buy the 72-hour install — $997Product tabsReviewsMerchant FAQ
01
Product FAQ / accordion missing on PDP — not product tabs, not reviews, not size chart, not recommendations.
Several PDP blocks can look like “the FAQ is broken.” They do not share a settings panel. This page is only when a product-specific FAQ / accordion never appears for buyers on the product page (product metafields / metaobjects, theme FAQ sections, FAQ apps, FAQPage schema on the PDP). Product description tabs that hold Shipping / Materials / Details are shopify-product-tabs-not-showing. Product reviews / star ratings are shopify-product-reviews-not-showing. Size chart / fit guide is shopify-size-chart-not-showing. Product recommendations / recently viewed carousels are a different product (recommendation apps / theme sections — not this FAQ accordion). Google FAQ rich results with no on-page accordion is adjacent to shopify-faq-schema-not-showing — schema visibility is not the same as a buyer-visible FAQ block.
02
Prove metafields vs theme FAQ sections vs FAQ apps vs schema FAQ on a live PDP.
Open a live product URL that should show a FAQ / accordion below the description or near the buy box — not only Theme editor preview. Capture four proofs before you install another FAQ app:
- Product admin → Metafields / Metaobjects: do FAQ question / answer entries exist for this product (list of metaobjects, rich text, or JSON)? Empty metafields render an empty accordion or nothing at all.
- Customize Current → product template: is there a FAQ / Accordion / Collapsible content section or block on the published product.json — not only on a draft template or an alternate template this SKU does not use?
- If you use a FAQ app: Theme settings → App embeds and product template theme app blocks — is the FAQ app enabled on Current with a block on this template?
- View source / Rich Results: is FAQPage JSON-LD present while the storefront still shows no accordion? Schema alone never paints a buyer-facing FAQ. DevTools: does an accordion DOM node exist but stay closed / height:0 under CSS or broken JS?
If you only tested product description tabs, a reviews widget, a size-chart popup, or a “You may also like” carousel, you are on the wrong playbook. If the on-page FAQ works but Google never shows FAQ rich results, chase shopify-faq-schema-not-showing instead.
03
Product metafields / metaobjects empty, wrong type, or not bound as dynamic sources.
Most native theme FAQ / accordion sections pull Q&A from product metafields or metaobject lists (namespace.key for questions / answers, or a list.metaobject_reference of FAQ entries). The definition can exist store-wide while this product has blank values. The section can be bound to the wrong namespace, a page metafield instead of a product metafield, or a Markets locale that has no translated FAQ entries. “Hide when empty” plus blank metafields looks identical to a broken theme.
Fix path: Settings → Custom data → Products → confirm the FAQ definition type matches what the theme section expects → open the product → fill question / answer entries (or attach metaobject entries) → Save. In Theme editor, bind the FAQ section’s dynamic sources to those metafields on Current. Retest the live PDP. Generic blank metafields (not FAQ) are product-metafields-not-showing. Translate & Adapt missing FAQ strings on Markets locales is shopify-translate-missing-strings.
04
Theme FAQ / accordion section missing from the published product template on Current.
Online Store 2.0 themes mount product FAQ via a Collapsible content / Accordion / FAQ section on the product template. That section can be removed from product.json, present only on a draft theme, restricted to a Markets country the buyer is not in, or placed on an alternate product template this SKU does not use. A description-tabs block is not a product FAQ section — tabs hold Materials / Shipping; FAQ holds Q&A pairs.
Fix path: Customize Current theme → Products → Default product (and any alternate templates your SKUs use) → Add section / block → FAQ / Accordion / Collapsible content → bind dynamic sources or paste Q&A → Save / Publish Current. Retest live. Product description tabs that never open are shopify-product-tabs-not-showing. Theme editor publish / save failures are theme-editor-publish-failing.
05
FAQ apps unpublished, or FAQPage schema present while the storefront accordion is still blank.
FAQ apps (theme app blocks / App embeds) can be off on Current, enabled only on a draft theme, or missing the product-template block after a theme swap. Duplicate FAQ apps often blank each other. Separately, SEO apps can inject FAQPage JSON-LD for Search Console while the visible accordion was never added — merchants then report “FAQ not showing” when they mean the storefront block, not rich results.
Fix path: Theme settings → App embeds → enable one FAQ app on Current → Save. Customize Current → add the FAQ theme app block to the product template → Save. If schema is present but buyers see nothing, add the visible FAQ / accordion section first; schema-only fixes belong on shopify-faq-schema-not-showing. Generic App embeds failing across many apps is app-embed-not-loading. CSS / JS that leaves an accordion node at height:0, or a consent manager holding the FAQ app script, is the same class of hide as other PDP widgets — inspect DevTools and allow the documented consent category.
06
You tested product tabs, reviews, size chart, or product recommendations instead.
Product description tabs / accordion missing are shopify-product-tabs-not-showing. Product reviews / star ratings missing are shopify-product-reviews-not-showing. Size chart / fit guide missing is shopify-size-chart-not-showing. Recently viewed / recommendations carousels are shopify-recently-viewed-not-showing (adjacent — not this FAQ accordion). Google FAQ rich results only is shopify-faq-schema-not-showing.
The only honest test for this page: product FAQ / accordion is missing on a live PDP that should show Q&A — fixable with filled product metafields / metaobjects, a FAQ section on the published product template, one FAQ app path if used, and no CSS / consent hide — not product tabs alone, not reviews alone, not size chart alone, not recommendations alone, not schema alone. Capture metafields + theme section + app path, fix the path. Anything else is a different product.
07
When to stay DIY vs pay $997.
Stay DIY if product FAQ metafields / metaobjects are filled, the FAQ / accordion section is on Current’s product template, any FAQ app path is enabled, and the accordion now shows on a live PDP. That is ordinary Shopify admin + theme work.
Pay $997 when the gap is wiring: lead capture, ops alerts, and a checkout-ready workflow on the stack you already pay for, installed in 72 hours after collaborator access lands. Latch does not sell an earnings, conversion, or FAQ-count number. Latch does not rebuild your theme’s FAQ Liquid as a design agency. One live store. Clock starts when collaborator access is in.