ComposeKit docs

Overview

ComposeKit adds a bundle/offer widget to your storefront. You create configurators in the app admin, choose which products they include, and set the discount. When a shopper clicks the add button, every component is added to the cart as a real Shopify line item and the discount is applied automatically at checkout — the shopper never needs a code.

Three things make up an offer:

• A parent product — the product that represents the bundle at checkout. Shoppers buy it, and it expands into its components.
• Component groups — the products inside the bundle, grouped into sections, each with its own selection and quantity rules.
• Pricing — a percentage, an amount, a fixed bundle price, quantity-break tiers, or BOGO rules.

The same pricing engine is shared by the storefront widget, the admin live preview, the POS tile, the cart and checkout — so what a shopper is quoted is what they are charged.

Installation

Activate bundle pricing NEW

One click on the ComposeKit home page — required before discounts work.

ComposeKit prices bundles with Shopify Functions, which have to be registered on your store. If they aren't, the home page shows a banner:

Click Activate bundle pricing and you're done — it registers ComposeKit's cart transform and checkout validation. A second, softer banner may appear: Checkout validation is off — activating it also blocks invalid configurations at checkout. The Pricing engine card at the top of the home page always shows the current state as Active or Inactive.

Place the widget

No code editing — the widget is a theme app block.

1. Go to Online Store → Themes → Customize.
2. Open the product template (or any other template) and add the ComposeKit configurator app block where you want the bundle to appear.
3. Save. The widget renders wherever an active configurator applies.

The block only renders when the product has an Active configurator and Hide bundle widget on product pages is off. In the theme editor you'll see a short placeholder message explaining which of those is missing.

Block settings

Shortcode placement NEW

Put a bundle widget on a landing page, a blog post, or anywhere in your theme.

Every configurator has a shortcode, shown in Step 1 of the editor and in the Shortcode column of the Configurators list (with a Copy button):

[composekit product="my-bundle-handle"]

There are two ways to use it:

1. As a section or block. In the theme editor, add the Bundle shortcode widget app section (or block) wherever you want the widget, and paste the shortcode into its settings.
2. Inside rich text. To use it in a page or blog body, turn on the ComposeKit shortcode app embed once (Theme settings → App embeds), then paste the shortcode into the content.

Shortcode attributes

[composekit product="my-bundle-handle"
            total="Bundle total"
            button="Add to cart"
            layout="cards"
            columns="3"
            scheme="dark"]

layout accepts cards, grid, list, compact or minimal; columns takes 1–8; scheme takes light or dark. The app embed itself also carries layout, columns, colour scheme, and optional border/spacing/padding overrides.

Templates & demo data NEW

Ten ready-made presets, plus a full demo catalog you can practise on.

The Configurator templates page gives you a working structure in one click — you only connect your own variants afterwards. Each card shows the plan it needs; most work on the Free plan.

Load demo data

The Load demo data button creates a full demo catalog (PC parts and coffee) with a working configurator for every feature. It is safe to run more than once: existing products and configurators are never overwritten, and missing product images are filled in.

The 5-step editor

A Setup progress card at the top tracks where you are — only two steps are required.

A Widget preview card sits beside the form on every step and renders the default selection with the same pricing engine the storefront and checkout use, so the total you see is the total your shopper pays. It also respects your current plan, so it shows exactly what will be saved.

Fixed bundles — “Better together”

A curated set of products sold together at a bundle price.

1. Create a configurator → choose Fixed bundle.
2. Add the products that make up the bundle and set each one's Quantity.
3. Set a bundle discount (percentage, amount off, or a fixed bundle price).
4. Set Status to Active and save.

Every component in every group always ships with the bundle at its configured quantity — shoppers don't pick or change quantities, so selection and quantity settings stay hidden. A component with a quantity above 1 shows as “× N” in the widget, and the editor shows the maths (price × qty = line total).

Example Coffee Grinder + House Blend → 10% off the set.

Multi-product bundles

Ship a fixed package, but let shoppers pick their option where it matters.

By default, every component in a multi-product bundle group ships with the bundle at its configured quantity — the shopper can see it but can't untick it. Turn on Let shoppers choose in this group to convert that one group into a pick-your-option step, while the rest of the package stays fixed.

Setting it up

1. Create a configurator → choose Multi-product bundle.
2. In Step 1, pick the product that represents the package at checkout (usually a dedicated “Bundle” product). Customers buy it and it expands into the components with the discount applied.
3. In Step 3 · Components, add a group for each part of the package.
4. Leave a group as-is to make it always included — set each component's Quantity and you're done.
5. Tick Let shoppers choose in this group on any group that should be a choice. The group resets to a clean single pick (Selection = Single, Required on) and the selection controls become editable for that group only.

How the two group types behave

Groups are independent, so one bundle can freely mix always-included groups with pick-one groups. Existing multi-product bundles created before this feature keep their original always-included behaviour.

Example A gift box that always contains the candle and the card, plus a group where the shopper picks one of three scents.

Mix & match — “Build your own”

Customers pick their favourites, with live pricing as they choose.

1. Create a configurator → choose Mix and match.
2. Add the eligible variants to a group and set Minimum / Maximum / Step (pick any N).
3. Set the bundle discount. The total updates live as items are selected.

Volume discounts — “Buy more, save more”

Quantity breaks that reward larger orders.

1. Create a configurator → choose Volume discount (quantity breaks).
2. Add tiers with Buy at least and Discount percent — e.g. 2+ → 10%, 3+ → 15%, 5+ → 20%.
3. Add as many tiers as you like; each must use a different quantity.

The highest tier the shopper reaches discounts the whole bundle. Tiers render as clickable pills reading “Buy 3+” / “Save 15%”, with a Best value badge on the top tier; reached tiers are highlighted. Clicking a pill bumps the selection straight to that tier's quantity.

BOGO — “Buy X get Y”

Buy X, get Y free — or at a partial discount.

1. Create a configurator → choose Buy X get Y.
2. Set Buy quantity (X), Get quantity (Y), and Get discount percent — 100 means free, 50 means half price.
3. Save. The discount applies automatically — no code for shoppers to enter.

ComposeKit repeats the cycle across the whole selection: buy 2 get 1 on 6 units discounts 2 units. The cheapest eligible units are the discounted ones, so the shopper always gets a fair result, and BOGO never stacks on top of the base bundle discount.

Composite configurator — “Guided builds”

Walk customers through required component groups to assemble a finished product.

1. Create a configurator → choose Composite configurator.
2. Add a group per decision (Processor, Memory, Storage…) and mark which are Required.
3. Optionally add compatibility rules so incompatible parts can't be combined.

Every component stays a real SKU in the cart, so stock and fulfilment work normally.

Free gift

Add a gift automatically once the shopper hits a threshold.

In Step 2, tick Offer a free gift and set:

• Gift variant — the product added as the gift.
• Unlock when — Total items reach or Subtotal reaches.
• Minimum items or Minimum subtotal — the threshold.

The widget shows live progress — “Add 2 more to unlock a free gift: Travel Mug” or “Spend $20.00 to unlock a free gift: Travel Mug” — and switches to “Free gift included: Travel Mug” when met. The gift is added by the pricing engine at 0.00, so it can't be gamed from the browser.

Subscription bundles NEW

Let shoppers buy the bundle once or on a recurring plan, discount intact.

1. In Step 2, tick Allow subscription purchase.
2. Make sure every component product is part of the selling plan offered on the parent product's page.
3. Save. Your theme's own selling-plan selector drives the choice — ComposeKit reads it.

When a shopper picks a selling plan, components are added as separate subscription lines and the bundle discount is applied automatically at checkout. When they pick one-time purchase, the normal merged bundle line is used instead.

Component groups & quantity rules NEW

Set in Step 3 · Components. Each group becomes a section in the widget.

Add components by searching (Search products or variants) and selecting several at once with Add selected components, or one at a time in single-selection groups. A variant can only appear once per group.

Per-unit variant pickers

Let a shopper buying three t-shirts choose a different size for each one.

When a bundle asks for more than one unit of the same product — a volume tier, a fixed quantity, a BOGO total — shoppers can pick that product's options independently for each unit, instead of being locked to a single variant for all of them.

Turning it on

1. Open the configurator → Step 3 · Components.
2. Inside the component box, find Let shoppers choose per unit and tick the options you want to expose — these are that product's own Shopify option names (Size, Colour, Model…). The control only appears if the product actually has options.
3. Optional: tick Also use as a variant selector for a single unit to show the dropdowns even at quantity 1. With it on, the row's title, price and image follow the picked variant; with it off, the dropdowns appear only from 2 units up.
4. Save the configurator.

What the shopper sees

A panel below the component with one row per physical unit — #1, #2, #3… — each with a dropdown per exposed option. Changing a dropdown swaps that unit to the matching variant and re-prices the bundle immediately. Sold-out picks are flagged inline and block add-to-cart. At a single unit the “#1” label is dropped, so it reads as an ordinary variant dropdown.

Good to know

• Duplicate picks are merged. If two units choose the same variant, the cart shows one line at quantity 2 — not two separate lines.
• Impossible combinations are ignored. If Size XL only exists in Black, selecting XL on a Red unit leaves that unit on its previous variant.
• Group rules still count the total. Min/max/step apply to all units of the component combined, so splitting across variants doesn't affect them.
• Re-save after variant changes. The sibling variant list (titles, prices, images) is captured when you save. After adding, renaming, or repricing variants in Shopify, re-open the configurator, re-tick the options, and save to refresh. Live stock is always checked at add-to-cart.
• Changing the base variant resets the picker. Switching a component's Variant, or re-adding the component, clears the per-unit selection.
• Works in subscription bundles too. Not yet supported in the POS tile — see POS.

Example “Buy 3 tees, save 20%” — the shopper takes S in navy, M in navy, and L in white, all in one bundle.

Pricing options

Set in Step 2 · Pricing. Hidden for Volume and Buy X get Y, which price from their own rules.

How the price reaches the cart

ComposeKit bakes the bundle discount into each component's unit price rather than applying it as a single line-level discount. Each cart line shows its own discounted share, and the bundle total is the sum of its components — so what the widget quotes is what checkout charges.

Discount cap NEW

A hard ceiling on how much any single order can be discounted.

Tick Cap the maximum discount in Step 2 and set Maximum discount amount. No order is ever discounted by more than this amount, whichever configurator type or discount you use — including BOGO, where every discounted unit is scaled down proportionally so the total lands exactly on the cap.

Useful for high-ticket catalogs where a flat percentage would give away too much on the biggest builds.

Block coupon codes NEW

Stop discount codes stacking on top of your bundle discounts. On by default.

Bundle discounts are already applied automatically, so a shopper who also enters a coupon code would be double-discounted. ComposeKit prevents that store-wide.

Go to Settings → Discounts:

• Block coupon codes on bundle orders — while any ComposeKit bundle is in the cart, coupon codes entered at checkout are rejected. On by default.
• Message shown under the discount code field — your own wording, up to 255 characters. Leave it empty for the default: “Coupon codes can't be combined with this bundle's discount.”

The setting applies to every Active configurator and takes effect at checkout as soon as you save.

Parent price sync NEW

Keep your bundle product honest in Meta, Google and TikTok catalogs.

A bundle's real price comes from its components, so the parent product's own price is often wrong — which is a problem the moment you publish it to an ad or social catalog.

Tick Keep parent product price in sync (ad & social catalogs) in Step 2. On save — and whenever a component's price changes — the parent product's price is set to the discounted total of the default selection, so ads, feeds and search results quote the right number.

Cart display & hiding the widget NEW

Cart line display

Cart line display in Step 2 chooses how the bundle appears in the cart:

• Grouped configuration — one bundle line named after the configurator.
• Separate components — each component is its own cart line, tagged with its group name. Requires Starter or higher.

What shoppers read in the cart

Grouped bundle lines carry readable line properties that any theme renders: Includes (e.g. “Ceramic Mug - Large × 2, House Blend × 1, Travel Mug × 1 (Free gift)”), Regular price, and You save. All three are translatable.

Hide bundle widget

Tick Hide bundle widget on product pages to keep the widget off the product page. Discounts still apply in cart and checkout, and the widget still renders anywhere you place it with the shortcode or the Bundle shortcode widget section.

Compatibility rules NEW

Step 4 — stop shoppers building something you can't ship.

Each rule reads as a sentence: If {variant}, then {action} {group}.

Rules are enforced everywhere — the storefront widget, the POS tile, the cart and checkout — so a rule can't be bypassed by editing the cart.

Appearance & layouts NEW

Six layouts, light/dark control, and spacing you can tune — no CSS.

In Step 5 · Style you also get Accent color, Border radius, Widget size (Compact / Standard / Large), Color scheme (Follow theme / Light / Dark) and Show ComposeKit branding. The store-wide Settings page adds Border width, Option spacing and Option padding.

Translations & custom text NEW

Two layers: store-wide labels, and per-bundle names.

Store-wide widget labels

Settings → Widget language overrides every label the widget shows, per locale:

{
  "fr": {
    "strings": {
      "required": "Obligatoire",
      "outOfStock": "Épuisé",
      "youSave": "Vous économisez {amount}"
    }
  }
}

Overridable keys: required, outOfStock, youSave, giftIncluded, giftSpendMore, giftAddMore, chooseOption, chooseOneOption, itemOutOfStock, quantitySteps, quantityMax, addToCartError, subscriptionUnavailable, quantityFor, cartIncludes, cartFreeGift, cartRegularPrice, cartYouSave. Leave it as {} for English defaults.

Per-configurator names

The Translations (optional) card in Step 2 overrides this bundle's title and group names per locale:

{"fr":{"title":"Configurez votre planche","groupNames":{"frame":"Cadre"}}}

Paste the JSON and click Apply translations.

Settings page NEW

Store-wide defaults, with a live preview beside them.

Everything here is a default — each configurator and each theme placement can still override it.

Automatic price refresh NEW

Component prices never go stale.

Most bundle apps store component prices when you save and let them drift. ComposeKit listens for product updates: when you change a variant's price in Shopify, every configurator using that variant is refreshed automatically, the parent price is re-synced if you enabled it, and the checkout pricing rules are rebuilt.

There is nothing to configure. If a total ever looks stale anyway, opening the configurator and saving it forces a full refresh.

Import & export NEW

Move a configurator between stores, or keep a backup.

• Export — the Export action in the Configurators list downloads that configurator as a JSON file.
• Import — Import from JSON at the top of the list accepts a dropped/uploaded file or pasted JSON. It is saved to the product named in the JSON, so make sure that product exists on the destination store.
• Each row also has a Copy button for the shortcode, plus Edit and Delete.

Analytics

The Analytics page shows, per configurator:

• Conversion funnel — Widget views → Adds to cart → Purchases, with the conversion rate between each stage and a bar chart.
• Views vs adds by configurator — paired bars for your eight busiest bundles.
• A table of every configurator with views, adds to cart and view → add conversion. Idle configurators are hidden behind a toggle.
• Bundle revenue and Top performer cards in the sidebar.

Views and adds to cart are tracked on all plans. Purchases and revenue require Growth or higher.

Point of Sale NEW

Build the same bundles on the shop floor.

The ComposeKit POS tile lets staff pick a configurator, choose components and add the configuration to the POS cart. It honours required groups, single/multiple selection, min/max/step quantity rules, compatibility rules and stock, and it writes the same data as the storefront widget, so the same pricing and validation apply.

Plans & billing NEW

Flat pricing, never revenue-based. All paid plans include a 14-day trial.

Switch Billing interval to Yearly to save 10%. Shopify prorates upgrades and downgrades. If you cancel, your store returns to the Free plan and configurators beyond the Free limits are paused, not deleted — they come back when you upgrade again.

How discounts apply

ComposeKit applies discounts using Shopify's native discount and Functions APIs. This means:

• Discounts apply automatically at checkout — customers don't enter a code.
• No Shopify Plus is required.
• It works alongside your existing theme without custom code.
• Widget price, admin preview, POS, cart and checkout all use the same pricing rules.
• Every component stays a real SKU, so stock, reporting and fulfilment behave normally.

Troubleshooting

FAQ

Support