Back to Kitforge Bundles
Integration guide

KitForge private cart line properties explained

KitForge private cart line properties mark widget-initiated adds — how they work and why they matter for discount attribution.

Kitforge Bundles Shopify bundles Integration guide

Quick answer

When shoppers use KitForge widgets to add FBT or quantity break offers, private line properties record the widget path. This enables widget-only discounts and analytics attribution distinct from manual add-to-cart.

  • Line properties mark KitForge widget-initiated cart lines.
  • Widget-only discounts depend on these properties at checkout.
  • Manual adds may explain discount and analytics mismatches.
  • Test mobile drawer carts for property preservation.

Why widget-only discount exists

Without line properties, checkout could not distinguish a quantity break tier selection from a single-unit manual add. Widget-only mode keeps displayed tier prices aligned with checkout charges.

Properties and third-party cart apps

Ajax cart drawer apps should preserve line properties when updating cart. Test drawer refresh after KitForge widget adds.

Final recommendation

KitForge private line properties connect storefront widgets to checkout discounts and analytics. Verify properties in cart when debugging pricing or attribution.

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

Are line properties visible to customers?

They are private cart line properties — used by KitForge Functions and analytics, not displayed on the storefront.

Do fixed kits use the same properties?

Fixed kits use Cart Transform with kit-specific line structure. FBT and QB rely more heavily on properties for widget-only discount paths.