Free Shipping Notice

Show shoppers how much more they need to spend to reach a free-shipping minimum. Use (BU)Free Shipping Text for a message, (BU)Free Shipping Bar for visual progress, or pair them in a Bricks cart, mini-cart, or checkout layout.

The notice displays progress toward an existing WooCommerce Free shipping method. It does not create a shipping method, change a rate, or select free shipping for the customer. The shipping options WooCommerce calculates from the completed delivery address are authoritative.

Set Up Shipping Regions and Zones


  1. In WooCommerce → Settings → General, check Shipping location(s) and allow the destinations you serve. Use a physical, shippable product when testing.
  2. Open WooCommerce → Settings → Shipping → Shipping zones. Click Add zone, give it a descriptive name, and select its Zone regions. A region can be a country or a subdivision, such as a state or province.
  3. For a smaller delivery area, use Limit to specific ZIP/postcodes. Enter one postcode, supported range, or wildcard pattern per line. For example, a local zone may cover selected postcodes within a larger domestic zone.
  4. Order zones from most specific to broadest. WooCommerce uses the first matching zone, not a combination of all matching zones. Put a local postcode zone above a statewide zone, and the statewide zone above the country-wide zone.
  5. Review Rest of the world. This is WooCommerce's fallback for addresses that match no named zone. Add methods there only if you want to serve those destinations. A customer in a named zone does not inherit rates from it.

For example, configure a Local zone with free shipping from 50, a broader Domestic zone with free shipping from 100, and an International zone with a paid rate only. Put Local before Domestic. Repeat the free-shipping method setup in each zone where the offer should apply. See WooCommerce's shipping zones guide for zone matching and postcode rules.

Configure the Free-Shipping Minimum


  1. Edit the target shipping zone. Add or retain a paid rate such as Flat rate if customers should still be able to order below the minimum.
  2. Click Add shipping method, choose WooCommerce's built-in Free shipping method, and make sure it is enabled.
  3. Under Free shipping requires, select A minimum order amount. Enter the amount, such as 100, in your store currency without a currency symbol. Save and check that the method appears in the intended zone.
  4. Decide whether to enable Apply minimum order rule before coupon discount. When enabled, the minimum is checked before coupon discounts; when off, a coupon can bring the eligible amount below the minimum. For example, an item subtotal of 110 and a discount of 20 can fall below a minimum of 100 when the check happens after discounts.

For a spend-based notice, use A minimum order amount and keep one enabled core Free shipping method per zone when possible. On the initial render, the notice takes the first enabled core Free shipping method in the resolved zone. A zero-cost Flat rate, Local pickup, or a custom rate named "Free shipping" is not the same method.

WooCommerce can also offer unconditional or coupon-based free shipping, or require a minimum and a coupon. The notice's amount-based progress cannot represent all of those rules. Reaching the displayed amount does not prove a required coupon was applied. For a coupon-only or unconditional offer, use a clear message about the actual offer instead of a spend progress bar. See WooCommerce's free shipping guide for each requirement.

How the Notice Chooses a Zone

When the cart has shipping selections or classic checkout recalculates, the notice can look up the zone for the first shipping package. When it cannot resolve a named zone that way, it falls back to IP-based country and region. That estimate has no postcode, so a visitor may see a broader zone before entering an address.

The built-in text and bar also try to refresh their target when the checkout country changes. That lookup uses the country alone; it does not reproduce full WooCommerce zone matching for state, postcode, or multiple packages. With overlapping zones or a different minimum per package, verify the displayed amount against the final checkout shipping options. Avoid promising free shipping for the whole order before all packages are rated.

Add the Notice in Bricks


  1. Go to Bricks → BricksUltimate → Misc, enable Free Shipping Notice, and save. The setting and elements require WooCommerce shipping to be enabled.
  2. Reopen the Bricks editor. Add (BU)Free Shipping Text, (BU)Free Shipping Bar, or both. Put them once near the order summary or at the top of your mini-cart, outside any repeated cart item.
  3. Configure the message, visibility, and styles below. If you use both elements and want them to appear together, give them the same visibility threshold.
  4. Preview on the storefront with a real cart and shipping destination. The editor may use a demonstration target of 200 when it cannot resolve a real one.

(BU)Free Shipping Text

In the Free Shipping Notice message, enter text such as Add ##update_min_amount## more to reach free shipping. The element replaces these tokens with amounts formatted in the store's currency:

  • ##update_min_amount##: The remaining amount while the cart is below the shipping minimum. Use it in the progress message.
  • ##min_amount##: The configured free-shipping minimum for the notice's chosen method.
  • ##cart_total##: The displayed merchandise subtotal. It is not the checkout total and may differ from the amount used for eligibility after discounts.

Under Action, choose Hide or Show success message. If showing success, enter a separate Success Message, such as You reached the free-shipping minimum. Use Text Typography and Price Typography to style the message and its amounts.

(BU)Free Shipping Bar

The bar displays the eligible cart amount as progress toward the method's minimum. An eligible amount of 75 toward a minimum of 100 fills roughly three quarters of the track. Use Hide price to hide the endpoint labels, or style their typography and gap. Under Progress Bar, Color sets the track, Alt Color sets the fill, and Height sets the thickness.

Enable Hide when free shipping rule is reached to remove the bar at completion. Leave it off to retain a filled progress bar. Pair the bar with text so shoppers do not have to infer eligibility from color alone.

Visibility Threshold vs. Shipping Minimum

Threshold amount on either element controls when shoppers start seeing that element. It does not change what they must spend. If WooCommerce requires 100 and the element threshold is 50, the message starts appearing at 50 and the shipping target remains 100. Enter the threshold without a currency sign, keep it below the shipping minimum, or leave it blank for no additional spend-based visibility gate.

Build a Custom Notice


For your own layout, use a Bricks Block or Div. Open Style → Free Shipping Notice Wrapper and enable Using as free shipping wrapper. This is optional; the built-in text and bar have their own settings.

  1. Add a progress message inside the wrapper. In a text element, use {fsn_updated_amount} for the remaining amount while below the minimum, and {fsn_min_amount} for the configured target. These Bricks dynamic tags are separate from the ##...## tokens used by the built-in text element.
  2. Give that message a unique class such as cart-shipping-progress. Enter .cart-shipping-progress in Free shipping notice selector.
  3. Choose Hide to hide the wrapper at the target, or Show success message to switch to a separate text element. Give the success element its own class, set Success message selector to match it, and style its initial visibility so it does not appear alongside the progress message before the first cart refresh.
  4. Test the custom wrapper with the cart below and above the target, including the first page load. Use unique selectors for each layout on the same page so a fragment update does not target another notice.

Test and Troubleshoot


  1. Test with a real shipping product and a complete address in a qualifying zone. Check totals below, exactly at, and above the minimum. Compare the notice with the shipping methods WooCommerce offers.
  2. Change the country, state, and postcode to test both another qualifying zone and a zone without free shipping. Check a new browser session without a saved address and a returning session with one.
  3. Apply and remove a coupon, then add or remove products and change quantities. Confirm the message and bar update on the Cart page, in the mini-cart, and at checkout wherever you display them.
  • No notice appears: Confirm the feature is enabled in Misc, WooCommerce shipping is active, the matching zone has an enabled core Free shipping method with a positive minimum, and the cart is above the visibility threshold. Also check whether the notice is configured to hide on completion.
  • The wrong region or amount appears: Check zone order, postcode rules, the completed shipping address, the Rest of the world fallback, and overlapping Free shipping methods. Test a fresh cart session after shipping configuration changes.
  • The notice and shipping rates disagree: Check discounts, tax display, coupon requirements, and split shipments. The notice uses a subtotal-based estimate, not the grand total. Use the actual checkout rate as the final check, especially with coupon tax, custom rate rules, or different currencies.
  • Text or bar does not update after a cart edit: The element uses classic WooCommerce cart fragments for live updates. Check that the page and mini-cart load those scripts, that cart requests are not cached, and that script optimization is not blocking refresh events. Test WooCommerce Cart or Checkout Blocks and AJAX-loaded layouts separately; do not assume they emit the same events.
  • Free shipping appears next to a paid rate: Multiple methods in the same zone are valid. If you want to hide other rates when free shipping qualifies, review the separate settings in Checkout Page → Misc, including the option to keep Local pickup. The notice itself does not filter rates.

Related BricksUltimate Tutorials