Quick answer
When a KitForge bundle widget does not appear on a product page, check three layers: the KitForge auto bundle card app embed in the theme editor, whether the bundle status is active, and whether the product is eligible as a trigger or component.
- Missing widgets are usually an inactive app embed, not a broken bundle.
- Active status and storefront activation are separate from saving a draft.
- Confirm /apps/kitforge/offers returns data before debugging discount logic.
- Re-enable the embed after every major theme change.
Why the widget depends on the app embed
KitForge deliberately keeps theme Liquid minimal. The app embed adds a data-kitforge-offers-root element on product pages; JavaScript fetched via the app proxy loads offers and mounts widgets near the add-to-cart area.
If the embed is off, there is nothing for the runtime to attach to — even when bundles are configured correctly in admin.
Step-by-step fix
In Shopify admin, go to KitForge → confirm at least one bundle is Active. Then open the theme editor, App embeds, and toggle on KitForge auto bundle card.
Visit a product that should show an offer. Open browser devtools → Network and confirm a request to /apps/kitforge/offers returns JSON with your bundle.
- Enable app embed and save theme
- Confirm bundle is Active with storefront activation on
- Test on a known trigger or component product
- Check app proxy response in Network tab
When manual app blocks are required
If widget position is set to manual_app_block, the auto embed alone is not enough. Add the matching KitForge section block to the product template and paste the bundle ID.
After a theme change or theme duplication, app embeds reset — re-enable KitForge in the new theme.
Final recommendation
Start every missing-widget report with the app embed and bundle status. Only then investigate product eligibility, coexistence rules, or manual block placement.
If you want this kind of offer to feel native to the buying journey, Kitforge Bundles is built around that exact problem: turning related Shopify products into clearer bundle offers before the shopper reaches checkout.
FAQ
Does KitForge work without enabling the app embed?
Only if you use manual theme blocks for each offer. The auto embed is the default path for product-page widgets.
I enabled the embed but still see nothing
Verify the product is a trigger (FBT), component (inline fixed kit), or eligible SKU (quantity break). Check coexistence settings — another offer type may hide this one.