Playbook · Product recommendations / related products blank
Shopify product recommendations blank on the product page.
Written for a Shopify owner or ops lead whose product recommendations or Search & Discovery related / complementary products stay blank or not showing on product pages. DIY-first: prove the empty recommendations section; check Search & Discovery related products; enable the theme Product recommendations section or app block; confirm intent and products_to_show; publish candidate products to Online Store. Distinct from upsell popup not showing, collection rules not matching, Buy Button embed not loading, theme app extensions not appearing, and Online Store 2.0 section groups broken. No earnings claims, no conversion-lift math, no invented case studies.
Nico at Latch AI Ops · Sep 10, 2026 · ~11 minute read
Buy the 72-hour install — $997Upsell popup not showingCollection rules not matchingMerchant FAQ
01
Product recommendations blank — not upsell popup, collection rules, Buy Button, theme app extensions, or OS 2.0 section groups.
Several “products will not appear next to this PDP” bugs look alike. They do not share one fix. This page is only when Shopify product recommendations or Search & Discovery related / complementary products stay blank or not showing on the product page. When an on-store upsell / cross-sell popup never shows, open upsell popup not showing. When automated / smart collection rules exclude products that should match, open collection rules not matching. When a Buy Button embed stays blank on an external host, open Buy Button embed not loading. When theme app blocks / embeds are missing in the theme editor, open theme app extensions not appearing. When Online Store 2.0 header/footer section groups will not render, open Online Store 2.0 section groups broken. This page is only: product recommendations / related products blank on the PDP.
Six ordinary reasons the recommendations area stays blank: Product recommendations section or Search & Discovery app block missing / hidden on the product template; products_to_show set to zero or wrong recommendation intent; Search & Discovery related / complementary products empty for that product; candidate products unpublished or unavailable; theme Liquid / section settings pointing at the wrong product ID; app or market catalog rules filtering every recommendation. Walk them in that order. You already pay for Shopify and Search & Discovery. You do not need another recommendations SaaS to prove related products can render on a PDP.
02
Prove recommendations are blank while the product page otherwise loads.
Open a live product page. Screenshot the blank related / recommended / complementary products area. Confirm title, media, and Add to cart still work — this is not a whole-PDP Liquid crash (liquid error on product page). In the theme editor on the product template, note whether a Product recommendations section or Search & Discovery related products app block exists and is enabled. In Apps → Search & Discovery, open Related products / Complementary products for that product and note empty vs pinned results. In DevTools → Network, look for empty productRecommendations / recommendations responses.
If the PDP loads but the recommendations strip is empty, stay here. If the failure is only an upsell popup after add-to-cart, leave for upsell popup not showing. If products are missing from an automated collection (not the PDP recommendations block), leave for collection rules not matching.
03
Repair Search & Discovery config, theme section, and recommendation intents.
In Search & Discovery, set related products and complementary products for the product (generate or pin), save, and confirm the intent matches what the theme section expects (related vs complementary). On the product JSON template, add or enable the Product recommendations section / Search & Discovery app block with a non-zero products-to-show count and the correct intent. Publish the theme. Confirm recommended products are active, published to Online Store, and not blocked by Markets / B2B catalog visibility. Retest in a clean browser; clear any app-side recommendation cache. Soft note: Search & Discovery collection filters empty is a different surface — see Search & Discovery filters empty.
Soft note: theme app blocks missing entirely from the editor is theme app extensions not appearing; broken header/footer section groups are Online Store 2.0 section groups broken. Latch’s 72-hour install is ops wiring on the live store — not a conversion-lift guarantee and not a merchandising agency retainer.
04
Checklist and how to prove related products show.
Checklist: (1) screenshot blank recommendations area on a live PDP, (2) confirm PDP otherwise loads, (3) check Search & Discovery related / complementary for that product, (4) enable Product recommendations section or app block with non-zero count and correct intent, (5) publish theme, (6) confirm candidate products published and available, (7) retest clean browser / clear app cache, (8) if only upsell popup / collection rules / Buy Button / theme app extensions / OS 2.0 section groups is wrong, switch playbooks.
Prove it: after the fix, the related / complementary products strip must show real product cards with titles, images, and links that open those PDPs. If recommendations show but an upsell popup still never appears after add-to-cart, open upsell popup not showing.
05
You tested upsell popup, collection rules, Buy Button, theme app extensions, or OS 2.0 section groups instead.
Upsell / cross-sell popup not showing is upsell popup not showing. Automated collection / smart collection rules not matching is collection rules not matching. Buy Button / Storefront Buy Button embed blank on an external site is Buy Button embed not loading. Theme app extensions / app blocks missing in the theme editor is theme app extensions not appearing. Online Store 2.0 section groups broken is Online Store 2.0 section groups broken. None of those fix a product recommendations / related products strip that stays blank on the PDP.
Finish prove blank recommendations → Search & Discovery / theme section / intent / publish candidates → cards-on-PDP proof first. Only then open the related playbook that matches the remaining symptom.
06
When to stay DIY vs pay $997.
Stay DIY if you can spend one afternoon on the list above: prove the blank recommendations strip, configure Search & Discovery related / complementary products, enable the theme section or app block with the right intent, publish candidate products, and stop treating upsell popup / collection rules / Buy Button / theme app extensions / OS 2.0 section groups as the same bug. That is the whole playbook. No agency required. Short answers also live on the merchant FAQ. Related pages: upsell popup, collection rules, Buy Button, theme app extensions, OS 2.0 section groups.
Pay $997 when the gap is wiring the stack you already pay for — lead capture, ops alerts, checkout-ready workflow on the live store — not when you only need related products to render on a PDP. One live store. No earnings claims, no ticket-cut promises, no conversion-lift math. Checkout: https://whop.com/checkout/plan_jHoFkwA8EXHTD.
Buy the 72-hour install — $997HomeFAQ
Nico at Latch AI Ops · Updated 2026-09-10 · DIY-first · No earnings claims