connect-telegram
Skip to main content

Set Up Freeshipping Threshold

The Freeshipping threshold setting lets you show a free shipping progress message on your storefront. This helps encourage customers to add more items to their cart to unlock free shipping.

For example, when the customer reaches the required amount, the message can change to:

Congratulations! 🎉 You’ve unlocked free shipping!

Important
The Freeshipping threshold setting in Theme Editor only controls how the free shipping message appears on your store. To make free shipping actually apply at checkout, you must also create a Free shipping promotion in the Promotion app.

On this page

  • How Freeshipping threshold works
  • Step 1: Enable Freeshipping threshold in Theme Editor
  • Step 2: Choose where to show the message
  • Step 3: Choose display style
  • Step 4: Customize threshold messages
  • Step 5: Create a Free shipping promotion
  • Step 6: Set purchase requirements
  • Step 7: Save and test

How Freeshipping threshold works

The Freeshipping threshold feature has two parts:

AreaPurpose
Theme EditorDisplays the free shipping progress message in cart or checkout
Promotion appCreates the actual free shipping discount rule

You need to complete both settings for the feature to work properly.

If you only enable Freeshipping threshold in Theme Editor, customers may see the message, but free shipping will not be applied unless the matching promotion is also created.

Step 1: Enable Freeshipping threshold in Theme Editor

First, enable the Freeshipping threshold display in your theme.

Steps:

  1. Log in to your BurgerShop admin.
  2. Go to Online store.
  3. Select Themes.
  4. Open the theme you want to edit.
  5. Click Customize.
  6. In the left sidebar, click General setting.
  7. Select Freeshipping threshold.
  8. Turn on the Freeshipping threshold toggle.

After enabling this setting, you can choose where and how the message appears

Step 2: Choose where to show the message

You can display the free shipping threshold message in the cart page, checkout page, or both.

Available options

OptionDescription
Show in cart pageDisplays the free shipping message in the cart page
Show in checkout pageDisplays the free shipping message during checkout

Steps:

  1. Go to General setting > Freeshipping threshold.
  2. Turn on Show in cart page if you want the message to appear in the cart.
  3. Turn on Show in checkout page if you want the message to appear at checkout.
  4. Review the storefront preview if available.
  5. Click Save.

Recommendation
Enable the message in both cart and checkout if you want customers to clearly understand how close they are to unlocking free shipping.

Step 3: Choose display style

The Display setting controls how the free shipping threshold message appears

StyleDescription
Only textShows the message as text only
Progress bar & textShows both the message and a progress bar

Steps:

  1. Go to General setting > Freeshipping threshold.
  2. Under Style, find Display.
  3. Select Only text or Progress bar & text.
  4. Review the preview.

Tip
Use Progress bar & text if you want customers to visually see how close they are to unlocking free shipping.

Step 4: Customize threshold messages

You can customize the message customers see before and after they unlock free shipping.

Message

The Message field is shown when the customer has not reached the free shipping requirement.

Example:

You’re only %amount% away from Free shipping

Use %amount% to automatically display the remaining amount needed for free shipping.

Success Message

The Success Message field is shown after the customer reaches the free shipping requirement.

Example:

Congratulations! 🎉 You’ve unlocked free shipping!

Steps:

  1. Go to General setting > Freeshipping threshold.
  2. Edit the Message field.
  3. Use %amount% where you want the remaining amount to appear.
  4. Edit the Success Message field.
  5. Click Save.

Step 5: Create a Free shipping promotion

After setting up the display message in Theme Editor, you must create the actual free shipping rule in the Promotion app.

Steps:

  1. From your BurgerShop admin, go to Apps.
  2. Make sure the Promotion app is enabled.
  3. Open the Promotion app.
  4. Click Create promotion.
  5. Select Free shipping.

This will open the Free shipping promotion setup page

Step 6: Set purchase requirements

To make free shipping apply correctly, create the free shipping promotion using the Automatic discount method and set a purchase requirement.

Steps:

  1. In the Free shipping promotion setup page, select Automatic discount.
  2. Enter a promotion title.
  3. Choose the countries where free shipping should apply:
    • All countries
    • Selected countries
  4. Under Minimum purchase requirements, choose Minimum purchase amount ($)
  5. Set the active date and start time.
  6. Optional: Set an end date.
  7. Click Save

Step 7: Save and test

After completing both Theme Editor and Promotion app settings, test the customer experience.

Test checklist

  • Add a product to cart.
  • Check whether the free shipping message appears.
  • Confirm the remaining amount is calculated correctly.
  • Add more products until the threshold is reached.
  • Confirm the success message appears.
  • Go to checkout.
  • Confirm free shipping is applied correctly.
  • Test both desktop and mobile views.