Skip to content

Concepts ​

This page explains the terms Unlock Bar uses, and why the bar always agrees with the checkout.

The ladder ​

Ladder. The ordered set of milestones in effect for one sales channel. There is one global ladder; a sales channel can have its own, which then replaces the global one in that channel.

Milestone. One step on the ladder: a threshold paired with exactly one reward.

Threshold. The cart value at which a milestone unlocks. Shown in another currency, it is converted and rounded up, and the rounded value is the threshold.

Unlock. A milestone is unlocked when the cart qualifies for its reward.

Qualifying amount ​

The qualifying amount is the single cart value that Unlock Bar compares with every threshold. It counts the products that ship, after promotion discounts. It leaves out:

  • downloads and other products without shipping;
  • products marked "free shipping" in their delivery settings;
  • the gifts themselves.

Because discounts count, a voucher moves the cart away from the threshold. The bar shows that, so it never promises free shipping that the voucher has just taken away.

Shopware's own shipping price matrix compares the goods before discounts. When your matrix makes the selected shipping method free sooner, the bar measures the free-shipping milestone the way the matrix does and shows the lower amount. Gifts and Unlock Bar's own free shipping always use the qualifying amount.

Rewards ​

Free shipping. €0 shipping that Shopware itself grants, either through your shipping price matrix or through a managed promotion. Unlock Bar never prices shipping itself.

Managed promotion. A Shopware promotion that Unlock Bar creates and keeps in sync for each free-shipping milestone. It is automatic (no code), makes shipping free with every shipping method, and is named after the milestone's title. You can see it under Marketing → Promotions, but Unlock Bar resets any edits there the next time the milestone is saved.

Gift. A product you give away at €0 once its milestone is unlocked. Each unlocked gift milestone adds its own gift.

Gift option. One of the products a gift milestone offers when the shopper may choose (Pro). The first option is the one added by default.

Removed gift. A gift the shopper took out of the cart. It stays out for the rest of that cart unless the shopper adds it back.

Why the bar never disagrees with the checkout ​

Many cart bars calculate free shipping on their own, with a threshold typed into the plugin. That copy drifts from what the checkout charges: a voucher lowers the basket, a currency rounds differently, a second shipping method has other prices. The bar then says "free shipping" while the checkout charges for it.

Unlock Bar avoids that in three ways:

  1. The checkout grants the reward. Free shipping comes from a Shopware promotion, and gifts are real product lines in the cart. The bar doesn't simulate either.
  2. The bar is computed inside the cart calculation, after promotions and shipping have been calculated, from the same cart the checkout uses. A free-shipping milestone counts as unlocked only when the calculated shipping costs really are €0.
  3. One measure for everything. The bar, the gifts, the managed promotion and the Rule Builder condition all compare the same qualifying amount with the same rounded thresholds.

The unlock moment and privacy ​

When a milestone unlocks, the bar animates its ✓ once, and with Pro it can play a celebration. Which milestones a shopper has already seen unlock is stored on the cart on the server. Nothing is stored on the shopper's device: no cookie, no local storage. The moment therefore needs no consent banner, and it doesn't replay on reload.

Look ​

Preset. A pre-designed look for the bar: Native, Minimal, Bold or Steps. Native follows your storefront theme; the others come with Pro.

Plans ​

Pro. The in-app purchase that unlocks unlimited milestones, gift choice, Rule Builder targeting and the presets. Without it, a ladder gives shoppers one free-shipping milestone and one gift milestone. Nothing you set up is deleted when Pro ends; see Get Unlock Bar Pro.

Your Vision. Signed, Sealed, Delivered.