Skip to main content
Discount types & pricing

Setting the discount label shown at checkout

Every offer in a Bundlex Bundles deal has its own title (for example, "Buy 3 with {{saved_percentage}} off"). By default, that per-offer title is what shows up next to the discount at cart and checkout. Customize cart & checkout labels lets you replace it with your own wording, either one name for the whole discount like "Black Friday", or a different name for each line.

What the labels do

Your labels override the per-offer title on every allocation the discount produces at cart and checkout. This only changes wording. It does not change the discount amount, the offer math, or anything in the product-page widget.

  • Leave everything blank and each line keeps the title it would have used anyway.
  • A label that is empty or only spaces counts as blank and falls back the same way.

How to set them

  1. Open the bundle deal you want to edit in the Bundlex Bundles dashboard.
  2. Go to the Advanced tab. In Cart and checkout, tick Customize cart & checkout labels.
  3. In the top field, All lines, enter one label for the whole discount (for example, Black Friday).
  4. Optionally fill in any of the lines below it to override a single line. An offer with only a main discount is one line named after the offer. An offer with free gifts, upsells or gift selectors shows its name over one line each for Main discount and those items. Progressive gifts and the upsell offer add-ons get their own groups.
  5. Save the bundle. Saving a published bundle sends the new labels to checkout.
Bundlex Bundles Cart and checkout section with customization enabled, All lines set to Aurelia bundle, an empty Main discount row and Free gift set to Complimentary balm.
1. Enable custom labels. 2. All lines supplies Aurelia bundle to the empty Main discount row. 3. Complimentary balm overrides that label for the gift only.

Each row's placeholder text shows you the label that line will use if you leave it blank, so you can see the result before typing anything.

The most specific non-blank label wins: a line's own label, then its offer's label, then All lines, then the fallback title. Setting an offer's main label (its own line, or Main discount under its name) also supplies the inherited label for that offer's gifts and upsells unless their own rows override it.

Unticking Customize cart & checkout labels clears every label you have entered, including any on lines not currently visible. Re-ticking it gives you empty fields, not your previous text.

Check the labels on a real cart

In this example, Buy 3 gives 20% off three $28 creams and adds a free $7 balm. Set All lines to Aurelia bundle, leave Main discount blank and set Free gift to Complimentary balm.

Aurelia cart with three creams labeled Aurelia bundle at $67.20 and one free Soft Lip Balm labeled Complimentary balm at $0.
1. The creams use the All lines label. 2. The gift uses its more specific label. The offer still costs $67.20 before shipping.
  1. Save and activate the deal, then add the qualifying offer from its product page to an empty cart.
  2. Check the discount name beside each discounted product. The widget should still use its original offer title.
  3. Continue to checkout and confirm the same names and discount amounts before placing an order. In this example, the creams save $16.80 and the balm saves $7, with a $67.20 product subtotal.

To test a more specific offer label, put Buy {{quantity}} save {{saved_percentage}} in Main discount. For this percentage offer, it becomes Buy 3 save 20% instead of Aurelia bundle. The gift keeps its own Complimentary balm override.

What each line falls back to

When no custom label applies, gifts, upsells and gift selector picks inherit their offer's title. Their widget titles remain separate product-page text. The table below assumes no line, offer or All lines override is set.

LineLabel used when you leave it blank
Main discountThe offer's title
Free giftThe offer's title
UpsellThe offer's title
Gift selector picksThe offer's title
Progressive giftThe title of the offer that unlocked it
Paid cross-sellIts own title
Upsell offer add-onIts own title

Cross-sells are not in the list

Paid cross-sells have no individual override row. Their fallback is their own title, but an offer label or All lines label still overrides it. To use a cross-sell's own title at checkout, leave those broader labels blank and edit the cross-sell title on the offer.

Template variables at checkout

You can use template variables in the label, the same {{...}} placeholders you use in offer titles. The catch is that the cart and checkout only have a limited set of data available, so most variables are stripped there. Only the ones Bundlex Bundles can compute from the offer itself survive.

Variables that survive at checkout

  • {{saved_percentage}} resolves for percentage offers and is stripped for other discount types.
  • {{quantity}} (and the legacy {{offer_quantity}}) resolves to the offer's quantity threshold.
  • {{buy_quantity}} resolves to the buy count (for Buy X Get Y, the paid items; otherwise the threshold).
  • {{get_quantity}} resolves to the free count (for Buy X Get Y; otherwise 0).

Variables that are stripped at checkout

These work in your product-page text but are removed from the label at cart and checkout, because that data is not part of the checkout's input:

  • Product, stock, and timer variables: {{product_title}}, {{stock}}, {{timer}}.
  • All price variables, such as {{saved_per_item}}, {{saved_total}}, {{price_per_item}}, and the compare-at price variables.

There is one exception. On upsell offer add-on lines, {{product_title}} does resolve at checkout, because that discount applies to a single known product. Everywhere else it is stripped.

If a label only contains variables that get stripped, the resolved text can come out empty. When that happens, Shopify falls back to its own default discount label.

One label vs. per-line savings

If your label includes a per-line variable like {{saved_percentage}}, it is resolved separately for each allocation. Paid cross-sells and upsell offer add-ons use their own discount; gifts, upsells and gift selector picks use their offer's discount. So a bundle with 20% off the main product and 10% off a paid cross-sell, using the label "Save {{saved_percentage}}", shows a different number on each line: the main line reflects its 20% and the cross-sell line reflects its 10%.

That is intentional, since those lines reflect their own savings. If you want one identical label on every line at checkout, use a plain label with no variables, such as Black Friday.

Tip: for a clean, consistent name across the whole discount (great for promo events), skip the variables and use a short fixed label. Save the variables for your product-page offer titles, where the full set is available.

Was this article helpful?

Your feedback helps us improve our docs.

Thanks - we'll keep improving this article.

Want to chat with our team? Still have a question?

Still need help?

Our team is one click away. Send us a message and we'll get back to you.

We use a few cookies to keep this site working, measure how it is used, and power our chat widget when you open it. See our cookie policy.