Back to Kitforge Bundles

Troubleshooting guide

Quantity break hidden when fixed kit exists on product page

Quantity breaks may hide when an inline fixed kit exists on the same PDP. KitForge QB default fixedKitCoexistence is hide.

Quick answer

Quantity break widgets default to hiding when a fixed kit inline purchase option is on the same product page. Change coexistence to show_below or show_above if tiered pricing should still appear.

  • QB hides by default when inline fixed kit is present.
  • show_below places tiers under the kit widget.
  • One QB offer renders per PDP.
  • Avoid competing discount stories on one SKU.

Decision guide

If customers usually buy single units in bulk, prioritize quantity breaks. If they buy curated kits, prioritize fixed kit inline and keep QB hidden.

Launch checklist

Reproduce quantity break hidden when fixed kit exists 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 “Quantity break hidden when fixed kit exists 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

Hidden quantity breaks often reflect coexistence defaults — not a bug. Choose the primary offer type for each hero SKU.

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

Can QB apply to kit components?

Quantity breaks target eligible products you select — typically the hero SKU, not the bundle parent.

What should I do before publishing changes related to Quantity break hidden when fixed kit exists 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.