niziou/freegift

Adobe Commerce free gift module for global and cart price rule gifts.

Maintainers

Package info

github.com/niziou/freegift-m2

Type:magento2-module

pkg:composer/niziou/freegift

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.0.0 2026-05-06 17:36 UTC

Requires

  • php: ^8.3 || ^8.4
  • magento/framework: ^103.0
  • magento/module-catalog: ^104.0
  • magento/module-config: ^101.2
  • magento/module-quote: ^101.2
  • magento/module-sales-rule: ^101.2
  • magento/module-store: ^101.1

OSL-3.0, AFL-3.0 274925e5497447c35c986c8eefbe04a0abbe6c28

This package is auto-updated.

Last update: 2026-05-06 17:41:31 UTC

README

Magento 2 / Adobe Commerce module that automatically adds one free gift item to qualifying carts. It supports a website-scoped global gift SKU and rule-specific gift SKUs on cart price rules.

Compatibility

  • Adobe Commerce / Magento Open Source 2.4.8-p4 and the 2.4.8 release line
  • PHP 8.3 or 8.4
  • Composer 2

Adobe lists Adobe Commerce 2.4.8-p4 as the latest stable 2.4.x patch release as of April 24, 2026. Adobe Commerce 2.4.9 is currently listed as beta, so this module targets 2.4.8-p4.

Features

  • Website-scope global configuration under Stores > Configuration > Sales > Free Gift.
  • Optional free gift fields on cart price rules.
  • Rule-specific gift SKU takes priority over the global SKU.
  • Adds only simple or virtual products without required options.
  • Forces gift quantity to 1, disables discounts for the gift line, and sets the gift price to 0.00.
  • Removes obsolete gift items when the cart no longer qualifies or a different rule-specific gift applies.

Installation

Install with Composer from this repository or copy the module directory to app/code/Niziou/FreeGift.

bin/magento module:enable Niziou_FreeGift
bin/magento setup:upgrade
bin/magento cache:flush

Configuration

  1. Create an enabled, in-stock simple or virtual product for the gift.
  2. Make sure the product has no required custom options and is assigned to the target website.
  3. Go to Stores > Configuration > Sales > Free Gift.
  4. Enable the global gift and enter the gift SKU.

For cart price rules, go to Marketing > Cart Price Rules and expand the Free Gift fieldset in the Actions area. Enable the rule gift and enter a gift SKU. When that rule applies to the quote, its SKU overrides the global gift SKU.

Testing

Run the focused unit suite from the module root:

vendor/bin/phpunit -c phpunit.xml.dist