Free gift with purchase for Magento 2 cart price rules: free products added automatically or chosen by the customer, spend-more notices, gift labels and a report of gifts given. Luma and Hyvä.
One-off payment, with 12 months of updates.
No subscription or automatic renewal. Keep using the versions included in your update period. Update and licence details
Composer package softaware/module-free-gift
A gift offer is a normal cart price rule: websites, customer groups, dates, coupons, conditions and priority work as usual.
The spend-more notice and progress bar show shoppers how far they are from a gift, on the product page, the cart or the top of every page.
Gift lines are checked whenever the cart totals are collected, also through REST and GraphQL, and their quantity is set by the offer.
All features
Feature tour
01 / 06
"Spend £100.00 more to get a free gift." with a progress bar, on the product page, the cart page or the top of every page.
02 / 06
The gift appears as its own line at the gift price, labelled with the offer, and is removed again when the cart no longer qualifies.
03 / 06
The cart page lists the gifts of a "customer chooses" rule. Configurable gifts get a size and colour choice.
04 / 06
Alpine.js and Tailwind templates for the gift choice, the notice and the mini cart. The Hyvä checkout uses the Luma checkout fallback.
05 / 06
Gift cards stack into one column on phones, with full-width buttons.
06 / 06
Gift SKUs, number of gifts, for every X items bought, maximum times per cart and the gift price: free, percentage off, amount off or a fixed price.
Live demo
A full Magento store with the module installed, on Luma and on Hyvä. The admin demo signs you in with one click.
Compatibility
| Latest version | 1.2.3 · 9 Oct 2026 |
|---|---|
| composer.json requires | php ~8.2.0||~8.3.0||~8.4.0||~8.5.0 magento/framework ~103.0.7 softaware/module-core ^1.0 magento/module-backend * magento/module-catalog * magento/module-catalog-inventory * magento/module-checkout * magento/module-config * magento/module-configurable-product * magento/module-customer * magento/module-quote * magento/module-sales * magento/module-sales-rule * magento/module-store * magento/module-ui * |
Installation
After you buy, create a Composer key in your account. Then, in the root of your Magento project:
01Add the repository and your key (once per project)
composer config repositories.softaware composer https://repo.softawarecommerce.com composer config --auth http-basic.repo.softawarecommerce.com PUBLIC_KEY PRIVATE_KEY
02Install the module
composer require softaware/module-free-gift
03Enable it
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy bin/magento cache:flush
The last three are only needed in production mode.
Prefer a zip? Every version you are entitled to can be downloaded from My modules. More about Composer access
User guide
For version 1.2.3. The same guide comes with the module, in docs/user-guide.md.
Give free or discounted gifts with ordinary cart price rules. Gifts are added to the cart automatically or chosen by the customer on the cart page, and a "Spend £X more to get a free gift" notice shows how close the cart is. This guide covers installation, settings, setting up offers, what customers see, the report and the command line.
On the demo, the Push It Messenger Bag page shows the spend-more notice of a "spend £100, get a free tote bag" offer.
| Magento | Open Source or Adobe Commerce 2.4.7 to 2.4.9 |
| PHP | 8.2 to 8.5 |
| Themes | Luma, Blank and themes based on them; Hyvä 1.3 and later (checkout through the Luma checkout fallback) |
| Other | softaware/module-core (installed automatically) |
Install with Composer from repo.softawarecommerce.com. Your access keys and the full set-up are described at https://softawarecommerce.com/shop/composer-access/.
composer config repositories.softaware composer https://repo.softawarecommerce.com
composer config --auth http-basic.repo.softawarecommerce.com PUBLIC_KEY PRIVATE_KEY
composer require softaware/module-free-gift
bin/magento setup:upgrade
bin/magento setup:di:compile # production mode only
bin/magento setup:static-content:deploy # production mode only
bin/magento cache:flushOn Hyvä, run your usual Tailwind build after installing (the module registers itself for Hyvä's Tailwind source scanning). The module is off after installation: switch it on under General > Enabled (section 3).
To update later: composer update softaware/module-free-gift, then the same bin/magento commands.
Stores > Configuration > Softaware > Free Gift (also Softaware > Free Gift > Configuration). All settings can be set per website and store view.
| Setting | Default | What it does |
|---|---|---|
| Enabled | No | Switches all gift rules on or off for this scope. When off, gift rules do nothing and gift lines are removed from carts the next time they change. |
| Add Removed Gifts Again | No | No: an automatic gift the customer removes stays out of that cart (the cart page offers to add it back). Yes: it is added again whenever the cart changes. |
| Gift Line Label | Free gift | Shown with gift lines in the cart, mini cart, checkout, orders, emails and invoices, next to the rule's label for the store view (or "Yes"). |
For rules with the action "Free gift: customer chooses gifts from a list".
| Setting | Default | What it does |
|---|---|---|
| Show Gift Choice on Cart Page | Yes | Lists the gifts on the cart page. Without it customers cannot pick those gifts. |
| Title | Choose your free gift | Heading of the gift choice box. |
| Button Text | Add free gift | Text of the button on each gift. |
| Show Notice in Mini Cart | Yes | "You can choose a free gift" with a link to the cart page. |
| Setting | Default | What it does |
|---|---|---|
| Show Notice | Yes | Shows how much more the customer needs to spend for a gift. |
| Show On | Product page, Cart page | Top of every page, Product page, Cart page. |
| Message | Spend {amount} more to get a free gift. | {amount} is replaced with the amount still to spend. |
| Show Progress Bar | Yes | A bar under the message showing how close the cart is to the gift. |
The notice uses active gift rules without a coupon (for the shopper's website and customer group) whose conditions contain a top-level "Subtotal (Excl. Tax)", "Subtotal (Incl. Tax)" or "Subtotal after discount" with "equals or greater than" or "greater than". Other conditions of those rules are not evaluated for the notice.
| Field | What it does |
|---|---|
| Gift SKUs | Comma separated. Automatic gifts: simple or virtual products without options. Gifts to choose: simple, virtual or configurable products. Out-of-stock gifts are skipped. |
| Number of Gifts | Automatic gifts: quantity of each gift SKU. Customer chooses: how many gifts the customer can pick. |
| For Every X Items Bought | 0 gives the gifts once per cart. For example 2: the gifts are given for every 2 qualifying items (buy 2 get 1, buy 4 get 2). |
| Maximum Times per Cart | Used with "For Every X Items Bought". 0 means no limit. |
| Gift Price | Free (100% off), Percentage off the gift price, Fixed amount off the gift price, or Gift costs a fixed price. |
| Gift Discount or Price | A percentage (for example 50), or an amount in the base currency for "fixed amount off" and "fixed price". |
Several gift rules can apply to the same cart. Priority and "Discard subsequent rules" work as for any cart price rule.
Spend-more notice. On the product page, the cart page and/or the top of every page: "Spend £100.00 more to get a free gift." with an optional progress bar.
Automatic gifts. When the rule applies, the gift is added as its own cart line at the gift price, labelled "Free gift" with the rule's label. Its quantity cannot be changed. If the customer removes it, it stays removed for that cart and the cart page offers Add it back (unless "Add Removed Gifts Again" is Yes).
Gift choice. For "customer chooses" rules, the cart page shows the gifts with their regular price crossed out and an Add free gift button. Configurable gifts have a size and colour choice. The mini cart says "You can choose a free gift" with a link to the cart.
| Hyvä | Mobile |
|---|---|
 |  |
When the offer stops applying. If the cart no longer qualifies (subtotal too low, coupon removed, another customer group after sign-in), the gift line is removed and the cart explains why.
Checkout, orders and documents. Gift lines keep their "Free gift" label in the checkout summary, the customer's and the admin's order views, order, invoice and credit memo emails and PDFs.
Guests and customers. Both get gifts. When a guest signs in, the carts are merged without duplicate gifts.
Softaware > Free Gift > Gifts Given lists every gift line of every order: purchase date, order, gift rule (linked, or "Deleted rule (ID n)"), gift SKU, gift, quantity, regular value, customer email and name, order status and store. It has filters and CSV and XML export.
bin/magento softaware:free-gift:rules [--rule=ID]Lists the gift rules with their gift SKUs and whether each gift can currently be given (exists, enabled, in stock). Use it after catalogue changes to find offers whose gifts can no longer be added.
| Resource | Allows |
|---|---|
| Softaware > Free Gift | The Free Gift menu |
| Gifts Given Report | The report and its export |
| Free Gift Configuration | The configuration section |
| Marketing > Cart Price Rules (Magento) | Creating and editing gift rules |
| Problem | Solution |
|---|---|
| No gift is added | Check General > Enabled for the store view, that the rule is active for the website and customer group, and that its conditions are met. Run bin/magento softaware:free-gift:rules to check the gift SKUs. |
| A gift is skipped | The gift product is out of stock, disabled, not in the website, or a type that cannot be a gift. |
| No gift choice on the cart page | Check Gift Choice > Show Gift Choice on Cart Page and that the rule's action is "customer chooses". |
| The spend-more notice does not show | The rule needs a top-level subtotal condition and no coupon; check Show On and flush the cache. |
| The gift appears twice | It cannot be added as a normal paid line through Reorder or a wish list; if a customer adds the same product from the catalogue, it is a separate, paid line by design. |
bin/magento module:disable Softaware_FreeGift
composer remove softaware/module-free-gift
bin/magento setup:upgradeBefore uninstalling, deactivate or delete the gift rules: their action is provided by this module. The table softaware_free_gift_rule and the columns quote.softaware_free_gift, quote_item.softaware_gift_rule_id and sales_order_item.softaware_gift_rule_id keep their data until you drop them.
Changelog
softaware/module-core instead of softaware/module-base. The admin menu and ACL now sit under Softaware_Core::core ("Softaware"); roles that had access keep it (migrated by module-core). After updating all SoftAware modules, softaware/module-base can be removed.softaware:free-gift:rules.FAQ
Something else on your mind? The developers who wrote the module answer before and after you buy.
Ask a question →Already installed it? Open a support ticket
Create a cart price rule under Marketing > Cart Price Rules and choose one of the two gift actions under Actions > Apply: "Free gift: add gifts automatically" or "Free gift: customer chooses gifts from a list". Then enter the gift SKUs in the rule's Free Gift section. Websites, customer groups, dates, coupons, conditions and priority work exactly as for any other cart price rule.
"Add gifts automatically" puts the gift SKUs in the cart as soon as the rule applies. "Customer chooses gifts from a list" shows the gifts on the cart page and the customer picks as many as the rule allows.
Yes. Set For Every X Items Bought, for example 2: the gifts are given for every 2 qualifying items (buy 2 get 1, buy 4 get 2). The rule's "Apply the rule only to cart items matching the following conditions" decides which items count. Maximum Times per Cart caps the number of times.
No. Gift Price can be free (100% off), a percentage off the gift price, a fixed amount off, or a fixed price, so offers such as "buy one, get the second at 50%" are possible.
Simple and virtual products (automatic or chosen) and configurable products (chosen, with a size or colour choice on the cart page). Bundle, grouped, downloadable products with links and products with required custom options cannot be gifts. Gifts that are out of stock, disabled or not assigned to the website are skipped.
No. The quantity is set by the offer: the quantity field of a gift line is read-only and larger quantities are reset with a notice.
It stays removed for that cart and the cart page offers "Add it back". If you prefer, set Add Removed Gifts Again to Yes and the gift is added again whenever the cart changes.
The gift line is removed and the cart shows "The free gift (name) has been removed because the offer no longer applies to your cart." This happens for any reason the rule stops applying, for example the subtotal falls below the threshold or a coupon is removed.
It is based on active gift rules without a coupon whose conditions contain a top-level subtotal condition ("equals or greater than" or "greater than"). It shows the amount still to spend and, optionally, a progress bar, on the product page, the cart page and/or the top of every page. Other conditions of those rules are not evaluated for the notice. It is loaded through customer data, so pages stay in the full-page cache.
Gift lines are separate cart lines priced through a custom price (0 for free gifts), so subtotal, tax and grand total are right in every currency. Gift lines are not discounted by other rules and do not count towards any rule conditions, so a gift cannot keep its own rule valid.
Gift lines are checked again whenever cart totals are collected, also through REST and GraphQL (cart items, coupons, payment information and order placement). "Reorder" and adding a former gift from a wish list are refused with a message; the offer adds the gift again itself when it applies.
Yes. Hyvä templates are included for the gift choice, the notice and the mini cart (Hyvä 1.3 and later). Hyvä Checkout is not supported; the Luma checkout fallback is.
Orders created in the admin do not get gifts added, multishipping checkout is not supported for gift lines, and gift settings are not part of the cart price rule REST API (they are kept when a rule is saved through the API).
Magento Open Source and Adobe Commerce 2.4.7 to 2.4.9, PHP 8.2 to 8.5.
Support
From the blog
A free gift offer goes wrong when the shopper cannot tell whether they qualify. How to set up gift rules on Magento 2 that are clear in the cart and tidy on the order and the refund.
We use necessary cookies to run this site and, with your permission, Google Analytics to understand how it is used. You can accept analytics, reject it or choose in the settings. Cookie policy
Choose which cookies you allow. Necessary cookies are always on because the shop cannot work without them. You can change your choice at any time with the "Cookie settings" link.
Needed for the basket, checkout, login and security. They do not track you.
Google Analytics: how many people visit, which pages they read and how they found the site. It sets the _ga cookies and sends usage data to Google.