PHPackages                             nicolasblancom/magento2-module-freeshippingbar - 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. nicolasblancom/magento2-module-freeshippingbar

ActiveMagento2-module

nicolasblancom/magento2-module-freeshippingbar
==============================================

The FreeShippingBar module shows a banner with a 'free shipping from X' price notice and makes the calculations.

021JavaScript

Since Oct 18Pushed 2y ago1 watchersCompare

[ Source](https://github.com/nicolasblancom/magento2-module-freeshippingbar)[ Packagist](https://packagist.org/packages/nicolasblancom/magento2-module-freeshippingbar)[ RSS](/packages/nicolasblancom-magento2-module-freeshippingbar/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Magento 2 FreeShippingBar module
================================

[](#magento-2-freeshippingbar-module)

Adds a banner to the top bar with a "Free shipping from X" price notice

It makes the calculations based on cart items

Table of contents
-----------------

[](#table-of-contents)

- [Summary](#summary)
- [Why](#why)
- [Installation](#installation)
- [Usage](#usage)

Summary
-------

[](#summary)

This module adds a banner to the top bar block (above all content) with a "Free shipping from X" price notice.

It checks the items added to the cart and makes the calculations to change the message based on those:

- If no cart item added, it shows a generic message "Free shipping if order is above X" (configurable though XML file).
- If items added to the cart but cart price is below a threshold, it shows a "Only XX.XX left to get free shipping" message (configurable though XML file).
- If items added to the cart and price is above or equals the threshold, it shows "Now you have free shipping for this order!" message (configurable though XML file).

Why
---

[](#why)

Because it is a simple way to add a very visible promo banner that goes straight to the point.

It does not have complicated options and it is configurated through xml files.

It does not have any admin options for configurations.

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

[](#installation)

```
composer require nicolasblancom/magento2-module-freeshippingbar
```

Usage
-----

[](#usage)

Just install it and you will start seeing the banner in the front.

### Change messages

[](#change-messages)

In `view/frontend/layout/default.xml` file, you will see three variables:

- messageDefault: it's the message when no items in cart, shows by default.
- messageLeft: it's the message when there are items in cart, but you have not reached the threshold yet.
- messageFree: it's the message for free shipping, when you already reached the threshold.

If you want to change those messages just extend this xml in your theme by copying it to: `//layout/default.xml`

### Change threshold

[](#change-threshold)

Similar to messages variables. In `view/frontend/layout/default.xml` file you will see:

`100`

If you want to change the threshold variable just extend this xml in your theme by copying it to: `//layout/default.xml`

###  Health Score

13

—

LowBetter than 1% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity20

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/5bea38acc05034e1e565893732a9e01101751bbd75fa7e0ac2b020b02149c796?d=identicon)[nicolasblancom](/maintainers/nicolasblancom)

---

Top Contributors

[![nicolasblancom](https://avatars.githubusercontent.com/u/14317448?v=4)](https://github.com/nicolasblancom "nicolasblancom (12 commits)")

### Embed Badge

![Health badge](/badges/nicolasblancom-magento2-module-freeshippingbar/health.svg)

```
[![Health](https://phpackages.com/badges/nicolasblancom-magento2-module-freeshippingbar/health.svg)](https://phpackages.com/packages/nicolasblancom-magento2-module-freeshippingbar)
```

PHPackages © 2026

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