The settings apply to all ladders. A single ladder can override the stacking and the threshold basis; everything else applies everywhere. Most settings can also be changed per website or store view (scope switcher at the top left).
Stores › Configuration › Magelan › Tiered gifts
You also get there through Marketing › Promotions › Tiered gift settings.
General
| Setting | What it does | Default |
|---|---|---|
| Enable tiered gifts | No switches off all gifts: the ladders and the gift actions of cart price rules. | Yes |
| When several tiers are reached | Only the highest tier reached: when a higher tier is reached, the gifts of the lower ones leave the cart. All tiers reached: a customer over €150 gets the gifts of all three tiers. | Only the highest |
| Threshold basis | Products incl. VAT or Products excl. VAT (B2B). Shipping and gifts never count. | Incl. VAT |
| Count the value after discounts | Yes: discounts of cart price rules and coupons lower the value that counts towards the thresholds. No: the value before discounts counts. | Yes |
| Customers may decline the gift | Shows “I don’t want a gift”. A declined gift stays out until the cart falls below the threshold and reaches it again; the customer can change their mind with “Choose a gift after all”. | Yes |
| Gifts count towards the shipping weight | No: a gift weighs nothing for shipping rates by weight. | Yes |

Display
- Progress on the cart page and Progress in the mini cart: the bar with the tiers and “€X more for a gift”.
- Gift badge on the product page: “Gift with orders over €50”, or “This purchase brings you a gift” when the product would reach the next tier.
- Gift picker in the checkout: a “Choose a gift” or “Change gift” button in the order summary (Luma and Firecheckout).
- Note “You can change the gift in the cart” in the checkout and Show which value counts (for example “Applies to the value of products incl. VAT after discounts, without shipping”).
- Accent colour (for example #047857) and Corner radius (px): the progress bar, reached tiers and the badge. A darker shade for text and a light one for backgrounds are derived automatically, with enough contrast.

Texts, tracking, advanced
- Texts: your own progress and badge texts, see Tiered gifts: texts per store view.
- GA4 events: gift_tier_reached, gift_picker_open, select_gift, decline_gift and gift_removed (gtag or dataLayer).
- Gift actions in cart price rules: see Free gift by rule (advanced).
- Debug log: writes the gift decisions to var/log/magelan_freegift.log. Switch it on only while looking for a problem.


