For gifts by cart value use a gift ladder: the customer sees the progress, can choose and change the gift. A gift by rule is the advanced way for cases a ladder does not cover because they depend on a product or category:
- a sample with every perfume bought (three perfumes, three samples),
- a gift only when buying from a certain category or a certain product.
The module adds two actions to the cart price rule: Free gift by rule (advanced) adds the gift once per cart, Free gift by rule, per cart item (advanced) adds it for every item that matches the conditions. The gift shows in the cart, the order and the invoice as with a ladder: regular price and a 100 % discount, and the customer cannot change its quantity.
1. Switch the actions on
Stores › Configuration › Magelan › Tiered gifts › Advanced
Set Gift actions in cart price rules to Yes and save. On new installations the default is No, so the admin offers one way to a gift. If you upgraded from version 1.x and already have gift rules, the setting is already Yes. Rules that already use the action work whatever this setting says.
2. Prepare the gift product
Catalog › Products
The gift is a simple or virtual product with a SKU, stock and its real price, without required options. Set Visibility to Not Visible Individually if you do not sell it on its own.
3. Create the rule
Marketing › Promotions › Cart Price Rules
Click Add New Rule and fill in the name, website and customer groups. Leave Coupon at No Coupon if the gift should apply automatically.
In the Conditions section add the rule’s conditions, for example a product from a category in the cart.
In the Actions section choose one of the gift actions under Apply, enter the number of gifts (usually 1) under Discount Amount (Gift Quantity) and the product SKU under Gift SKU. Several gifts are entered as SKUs separated by commas.
For a gift with every item, add a condition under Apply the rule only to cart items matching the following conditions, for example Category is one of Perfumes. Without it every item in the cart gets a gift.
Click Save and check the cart.
Common problems
I cannot find the action under Apply
The setting Gift actions in cart price rules is No. Switch it on as described in step 1.
The gift is not added
Check that the rule is active for the right website and customer group, that the SKU matches the product SKU exactly and that the gift is enabled, in stock and assigned to the website. A product with variants or required options cannot be a gift. Also check that Enable tiered gifts is on in the settings.
Too many gifts
With the “per cart item” action the number of gifts is multiplied by the quantity of matching items. For one gift per cart choose Free gift by rule (advanced).


