Skip to main content
Tiered Progress Bar and the Smart Cart

This article will show you how to add and configure the tiered progress bar to the Smart Cart.

Strauss Van Wagenen avatar
Written by Strauss Van Wagenen
Updated over 2 weeks ago

Tier Progress Bar

Introducing the Tiered Progress Bar! Brands can now offer multi-tiered rewards for purchasing more products from their store. With this feature, 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. 🌟🎁


Step by step walkthrough

Follow this step-by-step guide to get started with the tier progress bar! 🛒🚀✨


Enabling the Tier Progress Bar

Follow these steps to configure and enable the tier progress bar:

  1. Go to the Smart Cart settings page.

  2. Click "Add Component" in the "Goal Box."

  3. Select "Tier Progress Bar."

  4. Configure your bar settings.

  5. Set Tiers: Choose the rewards for each tier.

    1. You can offer either free shipping, free product, or an order discount. You can set one free shipping tier, and up to three tiers for free gifts, order discounts, or a combination of both (up to a total of three tiers) per bar.

  6. Configure discounts.

    1. Discounting via Shopify Functions is recommended. This can be done directly within the Tiered Bar settings and is available to all Shopify Plans.

    2. You can use Shopify Scripts but beware they are being deprecated By Shopify in 2025 and you will not be able to use the Order discounting tier option.

  7. Save your settings.

  8. Head to the discounting instructions below for a more comprehensive set of instructions based on each discount type.


Discounting on the Tier Progress Bar (TPB)

Free Shipping Settings

Here's a breakdown of the settings you'll find in the Free Shipping block. Remember, you must set your shipping rates in Shopify!

  1. Free Shipping on All Products (no minimum):

    • Free shipping will be applied regardless of cart total, which will set the tier to a $0 minimum subtotal.

  2. Unlock Price:

    • This is the amount required to fill the shipping bar completely. Rebuy calculates the cart subtotal and subtracts that amount from the Minimum Price to display the remaining amount for the customer to reach free shipping.

  3. Enable Presentment Currencies:

    • If your store is configured to present in multiple currencies, you have the option of choosing different currency thresholds to reach Free Shipping.

      • Please ensure that all Presentment Currency Minimums are higher than all of the Lower Tiers minimums + lower than all of the Higher Tier minimums.

      • If you are using multiple currencies, then you MUST make different tier bars for each of the currencies that you are allowing consumers to checkout with. This will prevent consumers from getting the free gifts if they do not actually qualify for it in one currency over another.

  4. Icon Size:

    • This will adjust the sizing of the icon in the tier bar for shipping.

  5. Free Shipping on Subscription Products:

    • Free shipping will be applied if there is any subscription product in the cart.

      • Example: If you are using Recharge or another subscription provider and offer free shipping for all subscription items, checking "Free Shipping on Subscription Products" will ensure that the free shipping bar immediately displays that free shipping has been reached as soon as a subscription product is added to the cart.

  6. Shipping Remaining Label:

    • This setting controls the text displayed when the shipping bar is not full. "Remaining_amount" subtracts the cart subtotal from the amount specified in the Minimum Price field.


Discounting on the progress bar with Shopify Functions

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:

  1. Enable Shopify Functions:

    • Scroll down to the Advanced Bar Settings.

    • Locate the Use Shopify Functions (Recommended) toggle.

    • Turn the toggle on to enable Shopify Functions.

  2. Set Up Your Discount Tiers:

    1. Free Shipping: You must configure the shipping rates within Shopify, we only display this discount on the tier progress bar.

    2. Free Product: This discount will be a product discount for the specific product you choose.

    3. Discount: This option is for discounting the entire order based on a percentage or fixed amount.

    4. Decorative-Only: Use this option to create a decorative-only tier. This means it won't add items to the cart or apply any discounts directly. A common use case is with the Selectable Gift-With-Purchase Widget, where reaching a specific threshold allows customers to select their gift.

  3. Save Your Work:

    • After setting up the discount tiers and enabling Shopify Functions, click on the Save button at the top right corner of the screen. (note that the previewer does not currently visualize the discounts in the smart cart).

    • Your discount will now be active and applied automatically based on the conditions you've specified.

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.

If you'd like to learn more about Shopify functions for discounting on the Tier Progress Bar, please check out this helpful video tutorial. Don't hesitate to reach out if you have any questions.


Discounting with Shopify Scripts

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.

Warning: 🚫 You cannot use the order discount tier while using Shopify Scripts. To access this feature, you must switch to Shopify Functions for discounting.

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

  1. Disable Shopify Functions:

    1. Your tier progress bar will default to use the Shopify Functions discounting. If you wish to use scripts, then you must disable this toggle first.

  2. Set Up Your Discount Tiers:

    1. Free Shipping: You must configure the shipping rates within Shopify, we only display this discount on the tier progress bar.

    2. Free Product: This discount will be a product discount for the specific product you choose.

    3. Decorative-Only: Use this option to create a decorative-only tier. This means it won't add items to the cart or apply any discounts directly. A common use case is with the Selectable Gift-With-Purchase Widget, where reaching a specific threshold allows customers to select their gift.

  3. Save Your Work:

    • After setting up the discount tiers and enabling Shopify Functions, click on the Save button at the top right corner of the screen. (note that the previewer does not currently visualize the discounts in the smart cart).

    • Your discount will now be active and applied automatically based on the conditions you've specified.

  4. Copy your script: After selecting the products for free gifts, you'll find a "Generate Line Item Script" button. Click to copy the Shopify script to your clipboard.

NOTE: Shopify Scripts for discounting is only compatible with Shopify Plus and available to merchants who were previously granted access to the Script Editor app in Shopify Admin. Shopify has since removed the Script Editor app from the Shopify App Store for new merchants.

Because Shopify Scripts will be deprecated by Shopify in August 2025, it is highly recommended to migrate over to using Rebuy's discounting feature using Shopify Functions.


Bar Settings Definitions

Progress Bar Settings

  1. Bar Name:

    • Description: This setting allows you to give your progress bar a unique name for easy identification in the admin panel. This is especially useful if you manage multiple progress bars.

  2. Limit Countries:

    • Description: This option allows you to restrict the visibility of the progress bar to specific countries. If left blank, the bar will be displayed to all countries by default.

    • Important Note: If you create multiple bars, ensure they have distinct country settings. Overlapping country selections could lead to conflicts or misconfigurations.

The previewer does not currently support tier progress bar multi-location previewing, so you may need to test country-specific settings on live environments.


Gift Settings

  1. Line Item Mode:

    • Description: When this mode is enabled, any gifts earned will be displayed as line items in the shopping cart. If the customer needs to select a variant (like size or color), these items will be shown in the Gift Area below the bar for selection.

    • When Disabled: The Smart Cart will instead show earned gifts directly in the Gift Area below the progress bar without adding them as line items.

  2. Gift Area Title:

    • Description: This title will appear above the gift selection area, which is located below the progress bar. It serves as a heading to indicate where the customer can see the gifts they’ve earned.

  3. Gift Area Display Details:

    • The gift area shows gifts that customers have earned from reaching certain thresholds on the progress bar. If Line Item Mode is enabled, this area is mainly used for showing gifts that require customer selection.

Advanced Bar Settings & Discounting

  1. Exclude Discounts from Subtotal:

    • Description: When enabled, this setting ensures that discounts are excluded from the subtotal calculation that the progress bar is based on. This is useful if you want to encourage customers to spend more without applying discounts prematurely.

  2. Use Shopify Functions (or Scripts):

    • Description: Here, you can select the discounting mechanism your store will use:

      • Shopify Scripts (Legacy): 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.

      • Shopify Functions (Recommended): The latest and more robust mechanism for discounting, offering better performance and more flexibility which can be used by both Shopify Plus and Non-Shopify Plus merchants.

    • Important Note: If an Order Discount Tier is active, you cannot switch between Scripts and Functions. You’ll need to remove the discount tier to change this setting.

If you are using Shopify Scripts or Shopify Automatic Discounts, you need to be sure that you have discounting and free shipping set up properly within Shopify. We are only visualizing those discounts, you must have the discounts configured within the Shopify settings.

If you are using functions, you can configure these discounts right in Rebuy but must still configure your shipping settings within Shopify.


Custom labels and text Settings

Feel free to customize these labels with HTML formatting to make them more visually appealing and engaging for your customers! 🌟📦

Product Discount Text:

  • The message displayed in cart and in checkout when the discount is applied. If multiple product tiers are present, the first discount text set will be used for all free product tiers.

Custom Tier Label:

  • This field allows you to display a unique tier label which replaces the default label.

Amount Remaining Label:

  • Accepts HTML

  • Available Variables:

    • {{remaining_amount}}

    • {{product_title}}

Amount Reached Label:

  • Accepts HTML

  • Available Variables:

    • {{product_title}}


Multiple Progress Bars to Target Specific Countries

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.

Here's how to set it up:

  1. Toggle on the Tiered Progress Bar.

  2. Click "Add New Bar."

  3. Name your bar to identify it.

  4. Check the box for "Only available for certain countries."

  5. Type in the 2-letter code for the desired country (e.g., US for the United States, CA for Canada), and press enter.

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. 🌍🚚


Additional Customizations

Exclude Discount Amount

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.

Switching the toggle will account for all discounts (manual, automatic, and script-based). When the toggle is ON, it will use the original total price (before any discounts) in the progress bar. When the toggle is OFF, it will revert to the default behavior.

Customize Colors

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:

  1. Go to the Rebuy dashboard and choose 'Manage Rebuy Theme.'

  2. In the settings, you can adjust the button background color to customize the color of the Tiered Progress Bar."


FAQS

  • How do Shopify Scripts and Automatic Discounts affect the cart subtotal and gift tiers?

    • 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.

  • What happens to the Shopify Script discounting is used for the tier progress bar and a customer applies a discount code?

    • 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.

  • Can gifts be removed when a discount code is applied?

    • 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.

  • Do I need to build a gift with purchase widget to use the tier progress bar?

    • 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.

  • Does Rebuy function with Shopify Markets?

    • 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 Markers, allowing you to optimize and personalize the shopping experience for your customers.

  • How will the tier progress bar via Shopify Functions discounts look in my Shopify admin portal?

    • 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.

  • Why aren’t my tier progress discounts visible in the previewer?

    • 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.

  • Can I exclude specific products from a "Spend $X, Get X% or $X off" promotion in the tiered progress bar?

    • Rebuy does not yet support product exclusions, however we do have an enhancement request on our product roadmap to release this functionality in the near future.

  • Can I prevent specific products from counting towards a Free Gift unlock price or "Spend $X, Get X% or $X off" unlock price in the tiered progress bar?

    • While this feature is not yet supported, there is currently an enhancement in the works to allow for greater flexibility for tiered bar promotions. We recommend keeping an eye on our "What's New at Rebuy" page to stay up to date on all new product enhancements.

  • Does the free shipping tier automatically apply free shipping rates to customer orders?


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

Did this answer your question?