Skip to content

Progress bars

Progress bars show how close a customer is to a goal, with text that changes when they reach it. There are two kinds: one based on the cart’s value and one based on its weight.

A progress bar reading ‘You’re $45.00 away from free shipping’ above a bar that’s 40% full

Requires: Shopify Plus. Available on the Free plan.

Setting What it does
Target The amount to reach, such as 100. The bar is full at this amount.
Target type What counts toward the target (see below)
Text (when in progress) Shown until the target is reached
Text (when complete) Shown once the target is reached

Target type options:

  • Use cart total for target calculations: Shopify’s checkout total, which includes shipping and taxes once they’re known.
  • Use cart subtotal for target calculations: The products’ value before shipping and taxes.
  • Use cart subtotal plus discounts for target calculations: The subtotal minus order and shipping discounts, whether automatic or from a discount code.

For most “free shipping over X” goals, use the subtotal. The cart total changes as shipping is added, which can move the bar mid-checkout.

Both text fields support dynamic text. To show the amount left to spend:

You're {{ toMoney(100 - orderSubtotal, currencyCode) }} away from free shipping

With a target of 100 and a $60 subtotal, customers see “You’re $40.00 away from free shipping”. See more examples.

The bar uses Shopify’s native progress bar, so its colors come from your checkout branding. Blocks created before the native bar was introduced keep their color settings.

Requires: Shopify Plus and the Business plan.

Setting What it does
Target cart weight The weight to reach, in kilograms
Text (when in progress) / Text (when complete) Use {{ totalWeight }} to show the cart’s weight in kg

Weights come from each product variant’s weight in Shopify. Grams, ounces, and pounds are converted to kilograms. Products without a weight count as zero.

A progress bar only shows progress. To actually give free shipping or a gift at the target, pair it with a function:

  • Leaving Target empty hides the block.
  • The bar is full at 100% and doesn’t go past it.
  • To change the whole look once the goal is reached, not just the text, create two blocks with opposite display rules (for example Cart subtotal is less than 100 and is more than 99.99) and list both in one app block’s Fixed block ID.
  • Older progress bars created from the retired “Progress bar” block still work and can still be edited.