Quick answer
KitForge bundle widgets on product pages require the auto bundle card app embed. Enable it once per theme in Online Store → Customize → App embeds, then save.
- App embeds are per-theme — duplicate themes need the embed re-enabled.
- This is separate from installing the KitForge app.
- Manual blocks are optional; the embed is the default auto-mount path.
- Save the theme after toggling or changes will not appear live.
Why Shopify requires an app embed
Theme app extensions cannot modify every template automatically. The body-targeted app embed is Shopify's supported way to inject KitForge on all product pages without editing Liquid.
KitForge onboarding treats this as step one because bundles cannot merchandize on the storefront until the mount point exists.
Enable the embed in under two minutes
From Themes, click Customize. In the left panel, open App embeds (puzzle-piece icon). Find KitForge auto bundle card and switch it on. Click Save.
If you use multiple themes (e.g., staging), repeat for each theme you test bundles on.
Verify it worked
On any product page, view page source and search for data-kitforge-offers-root. Or open KitForge admin — the inactive embed banner should disappear.
Launch checklist
Reproduce how to activate kitforge app embed in shopify theme editor 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 “How to activate KitForge app embed in Shopify theme editor,” 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
Enabling the KitForge app embed is the fastest fix for invisible bundle widgets. Do it before building your first campaign.
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
Do I need a developer to enable the embed?
No. Any staff with theme customization permission can toggle app embeds.
Can I use blocks instead of the embed?
Yes. Add KitForge section blocks to specific templates and set widget position to manual_app_block. The embed is still recommended for store-wide coverage.
What should I do before publishing changes related to How to activate KitForge app embed in Shopify theme editor?
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.