The Tiered Progress Bar lets brands offer multi-tiered rewards for purchasing more products from their store. You can create up to 3 bars for different geographies, each with up to 4 tiers of rewards: one free shipping tier and up to 3 free gift tiers per bar. The Tiered Progress Bar allows you to configure discounts directly within the Smart Cart's editor without needing to manually create them in Shopify.

Follow this step-by-step video guide to get started with the Tiered Progress Bar.

The Tiered Progress Bar is a built-in component of the Rebuy Smart Cart. Follow these steps to configure and enable the Tiered Progress Bar in Smart Cart:

The Smart Cart Tiered Progress Bar lets you choose what fills each tier using the Unlock Condition selector. Every progress bar supports two unlock conditions:

To set it, open the Smart Cart Tiered Progress Bar editor, go to Configure Tiers, and choose Item Quantity from the Unlock Condition dropdown on the first tier.

The Unlock Condition is set at the bar level. The first tier controls the condition and every other tier in that bar inherits it, so you cannot mix Price and Item Quantity tiers within the same bar. Any new tier you add to a quantity-based bar automatically inherits the Item Quantity condition and the item-count label defaults.

When a bar uses Item Quantity, the progress text shows a plain item count instead of a currency amount. The {{remaining_amount}} placeholder outputs the number of items remaining, for example "3 items away," and the collapsed tier summary row shows "Quantity: N" instead of a dollar amount.

Enable Presentment Currencies lets you type an exact unlock price for each currency your store sells in, on the Free Shipping and Free Product tiers of a Smart Cart Tiered Progress Bar. Without it, the Tiered Progress Bar converts each tier's Unlock Price from your store's default currency at Shopify's live exchange rate, so a shopper paying in another currency sees an unlock amount that is rarely a round number and that moves when exchange rates move. With it, a free gift can unlock at €90 for shoppers paying in euros and £80 for shoppers paying in pounds, while your default currency keeps its $100 Unlock Price.

The Enable Presentment Currencies toggle sits in its own card directly below a Free Shipping or Free Product tier. It appears when the bar's Unlock Condition is Price and your Shopify store sells in more than one currency, and it does not appear on bars set to Item Quantity. On the Free Shipping tier, turning on Free Shipping on All Products (No Minimum) hides the card, since that tier then unlocks at any cart total.

Per-currency unlock prices are set tier by tier, with a separate Enable Presentment Currencies toggle under each Free Shipping or Free Product tier.

Your default currency is not listed in the card, because the tier's Unlock Price already is the unlock price for your default currency.

If a currency's amounts do not rise from one tier to the next, the editor shows a warning. The warning does not stop you from saving, so check that each currency's amounts climb in tier order before you click Save.

Test per-currency unlock prices on your live storefront by switching to each currency your store sells in. On a cart where a Tiered Progress Bar uses Limit Countries, the bar still shows on your storefront for shoppers in its countries, but the Smart Cart previewer does not preview by country and leaves the Tiered Progress Bar out of the preview, so check that setup on your live storefront.

A shopper paying in a currency that has a per-currency unlock price is held to the amount you entered everywhere the Tiered Progress Bar uses that tier's threshold: the tier label, the {{remaining_amount}} message, and how full the bar is. On a Free Product tier, the Shopify Functions discount that makes the gift free checks the same per-currency amount at checkout, so a gift the bar shows as unlocked is discounted at that amount.

For example, a store with USD as its default currency sets a Free Product tier to unlock at $100 and enters 90.00 in Minimum Price EUR. A shopper paying in euros unlocks the gift at exactly €90.00, whatever $100 converts to that day. A shopper paying in a currency left at 0.00 unlocks the gift at $100 converted at Shopify's exchange rate.

Per-currency unlock prices on the Smart Cart Tiered Progress Bar follow the points below.

The Tiered Progress Bar Free Shipping Tier visually tracks a customer's progress toward qualifying for free shipping inside the Rebuy Smart Cart. As customers add items to their cart, the bar fills based on the cart subtotal relative to the configured threshold. Remember, you must set your shipping rates in Shopify.

To configure a Free Shipping Tier in the Tiered Progress Bar, follow these steps:

After saving, configure a matching free shipping rate in your Shopify Shipping Settings so the free shipping tier threshold and your actual shipping rules are aligned.

The Free Shipping Tier in the Tiered Progress Bar includes the following settings.

Setting path: Smart Cart editor → Tiered Progress Bar → Configure Tiers → Free Shipping

When enabled, the free shipping bar immediately shows as complete — no spend threshold required. Useful for stores that offer universal free shipping but still want the visual progress bar element. Same core limitation applies: this is visual only, actual free shipping must be configured in Shopify's shipping settings.

When enabled, the free shipping bar immediately marks as 100% complete as soon as a subscription product is added to the cart — regardless of cart subtotal. This is intended for stores using Recharge or similar subscription providers that offer free shipping on subscription orders. Again, the bar is visual — the matching free shipping rule must exist in Shopify.

Note: The Tiered Progress Bar has no setting that excludes a subscription purchase while still counting the same product bought one time, since Search Products to Exclude and a tier's Configure Exclusions exclude by product rather than by purchase option. If a product is only ever sold as a subscription, you can keep it out of every tier with Search Products to Exclude, or out of one tier with that tier's Configure Exclusions.

The Presentment Currencies setting on the Free Shipping tier lets you set a different free shipping unlock price for each currency your store sells in, using the Enable Presentment Currencies toggle in the card below the tier. The same toggle is available on Free Product tiers. Setup steps and where it applies are in the Set a different Tiered Progress Bar unlock price for each currency section of this article.

The Shipping Tier has a built-in default shipping icon, and the Configure Icon setting allows you to adjust the icon size. However, the icon itself cannot be swapped out natively within the settings — it's fixed to the default shipping icon out of the box.

Controls the message displayed when the customer has not yet reached the free shipping threshold. Supports a {{remaining_amount}} placeholder that auto-calculates the difference between the Unlock Price and the current cart subtotal, dynamically updating as items are added.

Example: "You're {{remaining_amount}} away from FREE SHIPPING!"

Controls the message displayed once the customer has met or exceeded the free shipping threshold — i.e., the bar is full. Typically used for a success/congratulations message. Example: "You've unlocked FREE SHIPPING!"

Rebuy offers built-in discounting for the Smart Cart Tiered Progress Bar. There are four tier types available: Free Shipping, Free Product, Order Discount, and Decorative-Only. Discounting is powered by Shopify Functions and is available to both Shopify Plus and non-Plus merchants. Merchants still on Legacy Smart Cart do not have built-in discounting — they'd need to configure Shopify Automatic Discounts manually.

This is enabled via Smart Cart editor → Tiered Progress Bar → Advanced Bar Settings → "Use Shopify Functions (Recommended)" toggle. Once on, discounts apply automatically when the configured unlock price is reached.

The Tiered Progress Bar's Free Product tier lets you offer a free gift when a customer's cart reaches a tier threshold. The threshold can be a spend amount or an item count, depending on the bar's Unlock Condition. With Price, the gift unlocks when the cart subtotal reaches the Unlock Price. With Item Quantity, the gift unlocks when the cart reaches the Unlock Quantity. When using Shopify Functions (recommended), the discount is applied automatically at checkout without needing to create a separate discount in Shopify.

The Free Product tier's threshold field depends on the bar's Unlock Condition.

With Price, the field is labeled Unlock Price and sets the cart subtotal threshold that fills the Free Product tier. Rebuy calculates the remaining amount by subtracting the cart subtotal from the Unlock Price. The Unlock Price is entered in your store's default currency, and Rebuy converts it for shoppers paying in other currencies at Shopify's exchange rate. To set an exact gift unlock price for a specific currency instead, turn on Enable Presentment Currencies in the card below the tier.

With Item Quantity, the field is labeled Unlock Quantity and sets the number of items that fills the Free Product tier. Enter a whole number only, with no decimals. Rebuy calculates the remaining count by subtracting the current item count from the Unlock Quantity. Currency conversion does not apply to a quantity threshold.

The icon setting controls the image displayed on the Tiered Progress Bar for this tier.

The Configure labels and text settings control the messaging displayed to customers on the Tiered Progress Bar for this tier.

Important:

You can configure a "Spend $X, Get X% or $X off" cart total promotion using Shopify Functions within Rebuy's Smart Cart Tiered Progress Bar (TPB). This feature can be used by both Shopify Plus and Non-Shopify Plus merchants.

Follow the steps below to set you your tier progress bar tier discounts using the Shopify functions discounting method:

WARNING: 🚫 When running other Shopify Discounts in parallel with a Rebuy Shopify Functions discount, you will need to set your other discounts to be combinable to ensure that they do not override Rebuy's Shopify Functions discounts. While Rebuy's discounts are automatically set to combine, Rebuy cannot control the settings of your other Shopify Discounts.

This action can be done in the Discount's Combinations settings within your Shopify Admin: For more information on Discount combinations, please refer to Shopify's documentation here.

NOTE: If you are using a third-party loyalty app (e.g., Smile.io, LoyaltyLion, etc.) that automatically generates Shopify discounts, including discount codes, please reach out to the respective app developer for instructions on how to configure their discounts to be combinable with other Shopify discounts.

TROUBLESHOOTING TIP: If tiered gifts are not triggering as expected after qualifying criteria are met, verify that all discounts, including Shopify discount codes, are set to be combinable. If a discount like 'WELCOME2' is not combinable, Shopify will only allow one discount to be applied at a time, potentially overriding the tiered gift discount.

When using Shopify Functions within Rebuy's Smart Cart Tiered Progress Bar (TPB), you can exclude specific products/variants from counting towards the Tiered Bar's discount unlock price subtotal amount. This allows you to have more control over which items contribute to your discount tiers and are eligible to receive an Order Discount.

Follow the steps below to enable exclusions for specific products/variants:

Configure Exclusions is a per-tier setting in the Smart Cart Tiered Progress Bar that keeps the products you choose from counting toward one tier's unlock threshold. It sits inside each tier under Configure Tiers, while the bar-wide Search Products to Exclude field in Advanced Bar Settings keeps excluding products from every tier on the bar.

Which exclusion types a tier's Configure Exclusions offers depends on the tier type, as shown in the following table.

To exclude products from a single Tiered Progress Bar tier:

To confirm the exclusion works, open your storefront in a private window, add an excluded product to the cart, and check that the remaining amount for that tier does not change. If it still moves, reopen the tier's Configure Exclusions and check that Enable Exclusions is on, that the product, its collection, or its tag is selected in a block, and that you saved the cart.

A product excluded in a tier's Configure Exclusions does not count toward that tier's unlock threshold, whether the tier unlocks by price or by item quantity, so neither its price nor its quantity moves that tier. The other tiers on the bar are unaffected and still count the product, unless it is also in Search Products to Exclude. The product still shows as a normal line item in the Smart Cart and is still charged at checkout. With Enable Exclusions off, the tier's exclusion blocks are hidden and none of them apply.

The Product Tags exclusion type in a tier's Configure Exclusions excludes products carrying the Shopify tags you select, from that one tier. The smart-cart-shipping-excluded product tag works separately from Configure Exclusions, keeping a product out of every Tiered Progress Bar in your store with no setup in Rebuy.

Products can be excluded from an Order Discount tier, but only bar-wide. Add them to Search Products to Exclude in the bar's Advanced Bar Settings, which keeps them from counting toward the Order Discount tier and every other tier on that bar, since an Order Discount tier has no Configure Exclusions section of its own.

Configure Exclusions on a Free Shipping tier changes only what that tier counts toward its threshold. Free shipping itself comes from the shipping rates set up in Shopify, so whether an order with an excluded product ships free is decided by those Shopify rates.

This is the older method for applying discounts, often used by merchants familiar with the older Shopify scripts app. This app is no longer available and when it was, it was only available for Shopify Plus.

If you wish to proceed and use Shopify scripts discounts for the tier progress bar, then you can follow the steps below.

If you are using the Rebuy Smart Cart's Tiered Progress bar, it is recommended to disable your Shopify theme's Cart page (example: mystore.shopify.com/cart), as this page can cause complications with Rebuy's Tiered Progress Bar logic.

To disable the Shopify "/Cart" page within your Rebuy Admin, navigate to the Smart Cart settings and ensure the "use cart page" is toggled OFF:

You can now create up to 3 tiers of progress bars for different geographies. This means if you offer free shipping and/or free gifts at different thresholds across various geographies, you can accurately display this information to your customers.

This allows you to tailor your rewards based on specific countries, providing a more personalized experience for your customers! 🌍🎁

For more detailed instructions on how to only show the Free Shipping Bar for specific countries, be sure to check out our comprehensive guide: "How To Only Show The Free Shipping Bar For Specific Countries." This guide provides step-by-step instructions to help you tailor your shipping offers to specific countries, ensuring a customized experience for your customers. 🌍🚚

When checked, alters subtotal calculation for the progress bar (and legacy free shipping bar). With this option enabled, TPB/Free Shipping Bar (legacy) displays the subtotal without factoring in calculated discounts from the shippingExcludedSubtotal method.

By default, the color of the tier progress shipping bar is derived from the color configurations in your Rebuy Settings. Follow the steps below to adjust these settings:

The Smart Cart Tiered Progress Bar supports quantity-based unlock thresholds through the Unlock Condition selector. Choose Item Quantity to unlock tiers based on the number of items in the cart instead of the cart subtotal. When Item Quantity is selected, the tier's Unlock Price field becomes an Unlock Quantity field that accepts a whole number, and the progress text displays an item count such as "3 items away." The unlock condition is set at the bar level and applies to every tier in that bar.

No, the Free Shipping tier is not an automatic trigger. It serves as a reference point for merchants to set up free shipping in their systems. You must configure your shipping rates in Shopify.

Customers not getting free shipping after the Tiered Progress Bar shows the Free Shipping tier as reached almost always means the bar's threshold and your Shopify shipping rate do not match. The Free Shipping tier displays progress toward free shipping, and Shopify decides whether an order ships free at checkout. To line them up, check the following:

You can show two free shipping milestones on one Tiered Progress Bar, though only one of them can be a Free Shipping tier, since a bar holds at most one of those. Set the first threshold as the Free Shipping tier and the second as a Decorative-Only tier with its own label, for example free shipping at $100 and free express shipping at $150. The Tiered Progress Bar only displays progress at each threshold, so create Shopify shipping rates that match what you promise at each threshold. A bar holds up to 4 tiers in total.

The Tiered Progress Bar still showing an old free shipping threshold after you change the Unlock Price usually means the storefront is showing a different bar or setting than the one you edited, or the page you are viewing loaded before the change. Check the following, in order:

Once the bar shows the new threshold, update your free shipping rate in Shopify under Settings > Shipping and delivery to the same amount. The Unlock Price controls what the Tiered Progress Bar displays, and Shopify controls whether free shipping applies at checkout.

No, Rebuy does not support A/B testing multiple free shipping thresholds because Shopify allows only one active free shipping rate at a time. Displaying different thresholds visually will not overwrite Shopify's actual shipping calculations.

Shopify Scripts and automatic discounts can modify the cart subtotal, which affects the price tiers associated with a gift. When the cart subtotal is adjusted, the price tier for the gift also changes, and the gift may be removed from the cart.

When a discount code is applied, the cart subtotal is not modified in the cart.json. Instead, the discount is applied directly to the cart. This means that the gift tiers remain unchanged, and we cannot detect that a discount code has been applied to remove the gift from the cart.

If you are NOT using Storefront API. No, due to the way discount codes are processed, we are unable to detect the code's application and adjust or remove the gift from the cart accordingly. This means customers might still receive gifts they are no longer entitled to, so it's important to carefully manage how discount codes and gift tiers are set up.

If you ARE using Storefront API, product type codes will remove gifts from the cart. Order type discount codes will NOT remove the gift from cart.

When using standard Discount Codes with stacking enabled, the discount input field disappears after the first code is applied, and savings are not visible in the cart. A Code Applied in Checkout message is displayed, and savings are displayed once as checkout.

With the Storefront API, multiple discount codes can be applied directly within the Smart Cart input field. This creates a smoother experience by keeping the input field visible, showing the applied discounts, and updating the cart subtotal in real time to reflect savings.

Yes, there are a few important limitations to keep in mind:

If you are using the tiered bar, you do NOT need to build a gift with purchase widget. If you do, that will double your gifts.

Yes, Rebuy widgets and features are designed to seamlessly integrate with Shopify Markets and multiple currencies. The compatibility ensures that you can enhance your Shopify store's functionality and user experience by incorporating Rebuy widgets. These widgets work in conjunction with Shopify Markets, allowing you to optimize and personalize the shopping experience for your customers.

Yes, a Tiered Progress Bar Free Product tier can unlock at a round amount you choose in each currency, such as €90 or £80, using Enable Presentment Currencies. Turn on the toggle in the card below the tier, enter a Minimum Price for each currency that needs its own amount, and click Save. Free Shipping tiers have the same toggle. Any currency left at 0.00 uses the tier's Unlock Price converted at Shopify's exchange rate, and Order Discount and Decorative-Only tiers always use the converted amount.

When you configure discounts using the Tiered Progress Bar via Shopify Functions, these discounts will appear in your Shopify admin portal in a specific way. Depending on the type of discount you set up, you will see them listed as separate function discounts. It's important to note that these function discounts cannot be directly edited within Shopify itself. Instead, all updates must be made within the discounting section of the Tier Progress Bar.

The Smart Cart previewer currently does not display discounts from the tier progress bar. You can use preview mode on your site to view the discount on the line item.

Shopify Functions must remain enabled because Discount Tiers, including Order Discounts, can only be powered by Shopify Functions. Disabling it would impact the functionality of your discount tiers.

No, you cannot disable Shopify Functions while Order Discount tiers are active. To disable Shopify Functions, you must first remove all Order Discount tiers.

Once you add an Order Discount tier, the Use Shopify Functions toggle will be locked in the enabled state. This is because Order Discounts can only be powered by Shopify Functions.
​

This is the expected behavior. It stems from built-in code protections designed to prevent potential inaccuracies that may arise when Shopify Order Discounts are utilized in conjunction with an Order Discount tier powered by Shopify Functions within the Tiered Progress Bar. When an Order Discount Tier is active, order-level discounts (automatic order discounts and order-type discount codes) do not lower the bar's progress. The tier grants its order discount once the customer crosses the threshold, so letting that discount lower the bar would drop them right back below the tier they just unlocked. Product-level and line-item discounts are not affected and still reduce progression.
​

At this time, two conditions are required. First, remove any Order Discount Tiers from your Tiered Progress Bar settings. Second, turn off Exclude Discounts from Subtotal. With no Order Discount Tier and that setting off, the bar tracks the true post-discount subtotal, which is the original subtotal minus automatic discounts, discount codes, and gift cards. If Exclude Discounts from Subtotal is on, the bar uses the pre-discount subtotal instead.

To disable Shopify Functions, you need to go to the Order Discount settings and remove all Order Discount tiers before you can turn off Shopify Functions.

If your Tier Progress Bar is configured for specific countries, the preview will only show all features when your current location matches those settings. To see all features in preview mode, ensure your location matches the regions you've configured for the bar.

When a customer applies a separate discount code, the behavior of the Tier Progress Bar (TPB) depends on whether the TPB contains an "order discount tier."

The Tiered Progress Bar does not detect or respond to Shopify free shipping discount codes as a trigger for the shipping tier being "reached".

Applying a shipping discount code does not affect the Tiered Progress Bar's (TPB) free shipping tier. If a customer applies a shipping discount code that grants free shipping, the TPB will continue to show the shipping tier as locked or in progress and it has no detection of shipping discount codes applied at checkout. The TPB's free shipping tier is controlled by the Unlock Price threshold you configure in the bar settings, and that calculation does not factor in whether a customer already has free shipping via a shipping discount code.

No, there is no built-in setting in the Smart Cart to automatically hide the Tiered Progress Bar or remove the shipping tier when a discount code is applied.

No, the Tiered Progress Bar does not evaluate in the Shopify Shop App. The Rebuy Smart Cart does not run on Shop App's checkout flow, so none of the Tiered Progress Bar's logic, including free shipping tiers, Free Product tiers, and Order Discount tiers, re-evaluates there.

The _r_declined_gifts order attribute is added when a customer removes a free gift from their cart after the Tiered Progress Bar added it. When a customer's cart subtotal reaches a Free Product tier's spending threshold, the Tiered Progress Bar automatically adds the gift to the cart as a line item. If the customer then clicks the standard remove control on that gift line item, Rebuy tags the resulting order with _r_declined_gifts to record that the customer removed it themselves.

This attribute is unrelated to Rebuy's GWP validation logic at checkout (the "GWP watcher"), which is a separate mechanism used only by the standalone Gift With Purchase widget on Shopify Plus stores. The GWP watcher automatically removes a gift when the cart's data source or discount conditions are no longer met at checkout. That watcher does not run against gifts added through the Tiered Progress Bar;

Note: Multiple orders can share the exact same _r_declined_gifts value. The value identifies the tier and gift product the customer declined, not the customer or session, so any order where a customer declines the same tier's gift will show an identical value.

The Tiered Progress Bar does not support displaying different free shipping thresholds based on customer segments such as order history, customer tags, or loyalty status. The thresholds a shopper sees can change with their country, using the Limit Countries setting on separate bars, and with the currency they pay in, using Enable Presentment Currencies on a Free Shipping or Free Product tier. Data Source rules also cannot change a Tiered Progress Bar threshold, because the Tiered Progress Bar reads its tiers from the Smart Cart's Tiered Progress Bar settings rather than from a Data Source.

Want to learn more about Rebuy features? Book a demo with our team today!