PHPackages                             chrismallory/module-freeshipping-progress-bar - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. chrismallory/module-freeshipping-progress-bar

ActiveMagento2-module[Utility & Helpers](/categories/utility)

chrismallory/module-freeshipping-progress-bar
=============================================

Display a progress bar on the shopping cart based on order total to encourage users to spend more to get free shipping

v1.2.3(3y ago)4915.4k↓28.6%16[3 issues](https://github.com/christophermallory/magento2-freeshipping-progress-bar/issues)OSL-3.0PHPCI passing

Since Feb 2Pushed 7mo ago6 watchersCompare

[ Source](https://github.com/christophermallory/magento2-freeshipping-progress-bar)[ Packagist](https://packagist.org/packages/chrismallory/module-freeshipping-progress-bar)[ RSS](/packages/chrismallory-module-freeshipping-progress-bar/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (2)Versions (10)Used By (0)

Magento 2 Free Shipping Progress Bar
====================================

[](#magento-2-free-shipping-progress-bar)

Description
-----------

[](#description)

[![Free Shipping Progress Bar](https://camo.githubusercontent.com/c3ada5b93be78cb6b53f528844e1721cd10f7b54a4bbe4cbd7a96db0c7256100/68747470733a2f2f692e706f7374696d672e63632f6a6463583246736e2f53637265656e2d53686f742d323032312d30322d30322d61742d31312d31322d32362d414d2e706e67)](https://camo.githubusercontent.com/c3ada5b93be78cb6b53f528844e1721cd10f7b54a4bbe4cbd7a96db0c7256100/68747470733a2f2f692e706f7374696d672e63632f6a6463583246736e2f53637265656e2d53686f742d323032312d30322d30322d61742d31312d31322d32362d414d2e706e67)

This Magento 2 module adds a free shipping progress bar to your Magento site's shopping cart to promote increased order value. The styles used were intended to allow for this module to be a drop-in feature for the luma theme or other themes based on it. All of the animations are CSS based and no javascript is used to limit overhead.

### Screenshots

[](#screenshots)

#### Order Value Below Free Shipping Minimum

[](#order-value-below-free-shipping-minimum)

[![Order Value Below Free Shipping Minimum](https://camo.githubusercontent.com/1fb267fca9b8d0f473580cd81fb04d40493c2a0c40f5ead07176b7dab654485e/68747470733a2f2f692e706f7374696d672e63632f32366e64444863362f53637265656e2d53686f742d323032312d30322d30322d61742d31312d32372d30382d414d2e706e67)](https://camo.githubusercontent.com/1fb267fca9b8d0f473580cd81fb04d40493c2a0c40f5ead07176b7dab654485e/68747470733a2f2f692e706f7374696d672e63632f32366e64444863362f53637265656e2d53686f742d323032312d30322d30322d61742d31312d32372d30382d414d2e706e67)

#### Order Value Over Free Shipping Minimum

[](#order-value-over-free-shipping-minimum)

[![Order Value Over Free Shipping Minimum](https://camo.githubusercontent.com/15ba086dd4544a4c039e12fda78589f1aef95bfb0d2dc9dee69b35d5c494724f/68747470733a2f2f692e706f7374696d672e63632f4a37714a354853392f53637265656e2d53686f742d323032312d30322d30322d61742d31312d32372d33382d414d2e706e67)](https://camo.githubusercontent.com/15ba086dd4544a4c039e12fda78589f1aef95bfb0d2dc9dee69b35d5c494724f/68747470733a2f2f692e706f7374696d672e63632f4a37714a354853392f53637265656e2d53686f742d323032312d30322d30322d61742d31312d32372d33382d414d2e706e67)

Installation
------------

[](#installation)

### Using Composer (Recommended)

[](#using-composer-recommended)

- Install the module composer by running `composer require chrismallory/module-freeshipping-progress-bar`
- Enable the module by running `php bin/magento module:enable ChrisMallory_FreeShippingProgressBar`
- apply database updates by running `php bin/magento setup:upgrade`
- Flush the cache by running `php bin/magento cache:flush`

### Manual File Transfer

[](#manual-file-transfer)

- Clone or unzip this repository to `app/code/ChrisMallory_FreeShippingProgressBar`
- Enable the module by running `php bin/magento module:enable ChrisMallory_FreeShippingProgressBar`
- Apply database updates by running `php bin/magento setup:upgrade`
- Flush the cache by running `php bin/magento cache:flush`

Configuration
-------------

[](#configuration)

This module adds new fields to the Sales > Checkout section of your stores configuration.

### How to Configure

[](#how-to-configure)

To access this module's configuration, navigate to `Stores > Settings > Configuration > Sales > Checkout` then expand the `Shopping Cart` group.

[![Free Shipping Progress Bar Settings](https://camo.githubusercontent.com/b5d87f2a4848db6ad2d938ffe133aef9faa1e86f52ce8b2d6b002105ef03c9f0/68747470733a2f2f692e706f7374696d672e63632f39586433384370332f53637265656e2d53686f742d323032312d30322d30322d61742d31312d34342d35302d414d2e706e67)](https://camo.githubusercontent.com/b5d87f2a4848db6ad2d938ffe133aef9faa1e86f52ce8b2d6b002105ef03c9f0/68747470733a2f2f692e706f7374696d672e63632f39586433384370332f53637265656e2d53686f742d323032312d30322d30322d61742d31312d34342d35302d414d2e706e67)

### Settings Explanation

[](#settings-explanation)

#### Enable Free Shipping Progress Bar

[](#enable-free-shipping-progress-bar)

If set to yes, a free shipping progress bar will be shown on the shopping cart in the cart summary. By default, the free shipping progress bar is disabled.

#### Use Free Shipping Method Configuration

[](#use-free-shipping-method-configuration)

If set to yes, this module will use the configuration for the core Free Shipping method. If that method is enabled then this Free Shipping Progress Bar will show based on that method's minimum order subtotal. If set to no, you will be able to set a custom order subtotal for this Free Shipping Progress Bar to show based on. This setting is primarily useful if your store is using a free shipping method other than the core Free Shipping method. By default, this setting is set to yes.

#### Free Shipping Progress Bar Minimum Order Total

[](#free-shipping-progress-bar-minimum-order-total)

When the above setting is set to no, this field is where you set the order value that the Free Shipping Progress Bar counts down to.

Compatibility
-------------

[](#compatibility)

This module has been tested and validated to work on Magento versions 2.3 to 2.4.3-p2.

This module uses a ViewModel and should be compatible with versions 2.2 and higher but has not been tested on versions lower than 2.3.

Bugs & Issues
-----------------

[](#bugs--issues)

If you find a bug or issue please create a new issue [here](https://github.com/christophermallory/magento2-freeshipping-progress-bar/issues) and include as much detail and context as possible including screenshots.

License
-------

[](#license)

This module is licensed under the Open Software License V3.0 which you can refer to [here](LICENSE.txt).

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance42

Moderate activity, may be stable

Popularity40

Moderate usage in the ecosystem

Community16

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~103 days

Recently: every ~129 days

Total

6

Last Release

1413d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6373ffc6af4bf4f878e75009ae39a4aea2cad0c90f81a0632ea5c0af7088942b?d=identicon)[chris.mallory](/maintainers/chris.mallory)

---

Top Contributors

[![christophermallory](https://avatars.githubusercontent.com/u/19673394?v=4)](https://github.com/christophermallory "christophermallory (12 commits)")[![thomas-kl1](https://avatars.githubusercontent.com/u/20971693?v=4)](https://github.com/thomas-kl1 "thomas-kl1 (2 commits)")

---

Tags

ecommercemagento2magento2-extension-freemagento2-modulemagento2-module-freeshopping-cart

### Embed Badge

![Health badge](/badges/chrismallory-module-freeshipping-progress-bar/health.svg)

```
[![Health](https://phpackages.com/badges/chrismallory-module-freeshipping-progress-bar/health.svg)](https://phpackages.com/packages/chrismallory-module-freeshipping-progress-bar)
```

###  Alternatives

[yireo/magento2-googletagmanager2

Add Google Tag Manager to Magento

167930.4k5](/packages/yireo-magento2-googletagmanager2)[mollie/magento2

Mollie Payment Module for Magento 2

1121.6M10](/packages/mollie-magento2)[hyva-themes/magento2-graphql-tokens

Adds Customer and Cart tokens to CustomerData sections

242.6M2](/packages/hyva-themes-magento2-graphql-tokens)[sbodak/magento2-checkout-custom-form

Add a custom form to Magento 2 checkout on the shipping step.

993.5k](/packages/sbodak-magento2-checkout-custom-form)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)