Free Shipping Bar

Free Shipping Bar allows your WooCommerce store to show customers how close they are to qualifying for free shipping with a dynamic progress bar that can appear on product pages, cart, checkout, mini cart, or across your site.

Installation

↑ Back to top

To start using a product from WooCommerce.com, you can use the โ€œAdd to storeโ€ functionality on the order confirmation page or the My subscriptions section in your account.

  1. Navigate to My subscriptions.
  2. Find the Add to store button next to the product youโ€™re planning to install.
  3. Follow the instructions on the screen, and the product will be automatically added to your store.

Alternative options and more information at:
Managing WooCommerce.com subscriptions.

Setup and Configuration

↑ Back to top

Getting started

↑ Back to top

To set up your store with Free Shipping Bar:

  1. Go to: WooCommerce > Settings > Free Shipping Bar.
  2. In the General tab, tick the checkbox to Enable Progress Bar.
  3. Enter your Free Shipping Threshold so it matches the free shipping rule configured in WooCommerce Shipping.
  4. Add your Initial Message and Success Message. Use the {amount} placeholder in the initial message to show the remaining amount.
  5. Choose whether to show a Continue Shopping link and customize its text if needed.
  6. Save changes.

Advanced configuration

↑ Back to top

Free Shipping Bar includes several tabs so you can fine-tune how the progress bar works and where it appears.

  • Design: Choose between toast notification, inline bar, or page-specific display modes, then customize colors, text styling, bar height, border radius, icons, and button styling.
  • Display Locations: Show the bar on product pages, cart, checkout, mini cart, or sitewide. Each supported location also includes position options such as top floating, bottom floating, or embedded placements.
  • Countries: Add country-specific thresholds and enable geolocation so shoppers see the most relevant free shipping target for their location.
  • Analytics: Track views, conversions, average cart totals, country performance, and export analytics data to CSV.
  • A/B Testing: Create variants with different thresholds, messages, traffic splits, and bar colors to compare performance.

You can also place the progress bar manually with the shortcode [wc_free_shipping_bar] or by using the template hook do_action( 'wc_fsb_display_bar', 'custom' );.

Usage

↑ Back to top

When the plugin is enabled, customers see a progress bar that updates as their cart changes. If they have not yet reached the threshold, the bar shows how much more they need to spend. Once they qualify, the success message appears instead.

Depending on your configuration, the bar can appear below the add to cart button on product pages, under the total on the cart page, before order totals on checkout, inside the mini cart, or as a floating sticky bar across the site.

Troubleshooting

↑ Back to top

Here are some common issues and how to solve them.

  • The progress bar does not appear: Check that WooCommerce is active, the plugin is enabled, at least one display location is selected, and your store has a free shipping method configured.
  • The threshold or message looks wrong: Confirm that the threshold amount matches your shipping setup and that the initial message still contains the {amount} placeholder if you want the remaining amount displayed.
  • Country-specific values are not showing: Make sure geolocation is enabled and that the relevant country threshold has been added in the Countries tab.
  • The bar is not updating after add to cart: Test for JavaScript errors and confirm that AJAX add to cart is working correctly on your site.
  • Analytics data is missing: Enable analytics in the General tab. If the analytics table has not been created yet, use the button in the Analytics tab to create it.
  • The styling does not match the theme: Review your Design tab settings first, then use custom placement or theme CSS if you need tighter integration.

FAQs

↑ Back to top

Help customers by answering commonly asked questions.

Does Free Shipping Bar require WooCommerce?

  • Yes. Free Shipping Bar is built for WooCommerce stores and requires WooCommerce to be installed and active.

Where can I display the progress bar?

  • You can display it on product pages, cart, checkout, mini cart, or sitewide. It can also be placed manually with the shortcode [wc_free_shipping_bar] or the template hook.

Can I use different free shipping thresholds for different countries?

  • Yes. The Countries tab lets you set country-specific thresholds, and geolocation can automatically show the correct value based on the shopper’s location.

Does the progress bar update automatically when the cart changes?

  • Yes. The bar updates dynamically as products are added to the cart, including AJAX add to cart flows when supported by the store.

Can I customize the design and messages?

  • Yes. You can customize messages, colors, icons, bar height, border radius, animation style, display mode, and continue shopping button styling.

What analytics and testing features are included?

  • The plugin can track views, conversions, country performance, and average cart totals. It also includes A/B testing so you can compare variants with different thresholds, messages, and colors.

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.