Free gift by rule (advanced)

A gift through a cart price rule, for product or category conditions that a gift ladder by cart value does not cover, for example a sample with every perfume.

⏱ 6 minAdvancedUpdated 14 Oct 2026

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

  1. Click Add New Rule and fill in the name, website and customer groups. Leave Coupon at No Coupon if the gift should apply automatically.

  2. In the Conditions section add the rule’s conditions, for example a product from a category in the cart.

  3. 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.

  4. 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.

  5. Click Save and check the cart.

Conditions of cart price rules (subtotal, quantity, weight) do not see the gifts, so a gift does not decide whether a rule applies. If a ladder gives the same gift, the customer could get it twice; the ladder preview warns about it.

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).

Was this article helpful?

Related