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:
| Area | Purpose |
|---|---|
| Theme Editor | Displays the free shipping progress message in cart or checkout |
| Promotion app | Creates 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:
- Log in to your BurgerShop admin.
- Go to Online store.
- Select Themes.
- Open the theme you want to edit.
- Click Customize.
- In the left sidebar, click General setting.
- Select Freeshipping threshold.
- 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
| Option | Description |
|---|---|
| Show in cart page | Displays the free shipping message in the cart page |
| Show in checkout page | Displays the free shipping message during checkout |
Steps:
- Go to General setting > Freeshipping threshold.
- Turn on Show in cart page if you want the message to appear in the cart.
- Turn on Show in checkout page if you want the message to appear at checkout.
- Review the storefront preview if available.
- 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
| Style | Description |
|---|---|
| Only text | Shows the message as text only |
| Progress bar & text | Shows both the message and a progress bar |
Steps:
- Go to General setting > Freeshipping threshold.
- Under Style, find Display.
- Select Only text or Progress bar & text.
- 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:
- Go to General setting > Freeshipping threshold.
- Edit the Message field.
- Use
%amount%where you want the remaining amount to appear. - Edit the Success Message field.
- 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:
- From your BurgerShop admin, go to Apps.
- Make sure the Promotion app is enabled.
- Open the Promotion app.
- Click Create promotion.
- 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:
- In the Free shipping promotion setup page, select Automatic discount.
- Enter a promotion title.
- Choose the countries where free shipping should apply:
- All countries
- Selected countries
- Under Minimum purchase requirements, choose Minimum purchase amount ($)
- Set the active date and start time.
- Optional: Set an end date.
- 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.