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.
Launch checklist
Reproduce kitforge bundle widget not showing on product page on a known product with a clean browser session after confirming the app embed is active.
Confirm variant coverage, mobile layout, and that the discount only applies through the intended path so shoppers are not surprised at checkout.
- Preview the offer on a real product page and on mobile.
- Place a test order that exercises the discount and inventory path.
- Brief support on what is included and what is not.
- Document the success metric before you scale the offer.
Mistakes that quietly kill conversion
Debugging discounts before confirming the widget mounts wastes time. Network responses from the Kitforge offers proxy should be the first technical check.
For “KitForge bundle widget not showing on product page,” keep the page focused on one primary next step. Extra widgets, stacked badges, and unclear exclusions increase bounce more often than they increase AOV.
- Do not hide eligibility rules until checkout.
- Do not bundle unrelated leftovers without a customer story.
- Do not skip mobile QA on choice-heavy widgets.
- Do not launch without a rollback plan for the discount.
How to measure whether it worked
A fix is complete only when the storefront, cart line properties, and checkout total all match the intended offer.
If the metric moves but support volume rises, fix presentation or inventory rules before cloning the offer across more SKUs.
- Attach rate on treated product pages
- AOV and contribution margin after discounts
- Refund or fulfillment exception rate
- Time for a teammate to edit the offer safely
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.
What should I do before publishing changes related to KitForge bundle widget not showing on product page?
Preview on mobile, place a test order, and confirm inventory and discount behavior match the storefront promise. Only then activate for all traffic.
When is Kitforge Bundles the wrong tool?
If you only need a simple Buy X Get Y or free-gift discount with no product-page merchandising, native Shopify discounts may be enough. Kitforge is built for fixed kits, FBT, and quantity-break widgets with inventory validation.
How long should I wait before judging the offer?
Give the offer at least one to two weeks of normal traffic, or enough orders to see attach rate stabilize. Seasonal spikes can distort a shorter window.