Free gifts
A free gift for the order total or for buying selected products.
A gift works where a discount no longer convinces: shoppers top up their cart to reach the threshold, the average order value grows, and the shop pays the cost of one product instead of a percentage off every sale.
What it does
- Gives a product away for the order total, in tiers: "spend 2000 — get a cream, spend 3500 — a cream and a pouch". A higher tier adds gifts to the lower ones, or replaces them when tiers are set as ranges.
- Gives a gift for buying particular products, brands or categories — "a pack of coffee with a coffee machine" — where the order total plays no part.
- Counts the threshold by the number of items as well, not only by money: "buy three packs, the fourth is a gift".
- Puts a single gift in the cart on its own and lets shoppers choose when there are several — you decide how many they may take.
- Shows a "350 ₴ left to your gift" bar in the cart, and a note on the product page that a gift comes with it.
- Caps the giveaway: per order, per shopper and per campaign in total. Once the stock you set runs out, the gift stops being offered.
- Sells the gift for a token price if you set one, such as 0.01. The gift then appears on the fiscal receipt, because the register cannot sell an item priced at zero. Whether gifts are printed on the receipt is up to you in the cash register card.
- Never promises what the warehouse does not have: a gift that ran out disappears from the list on its own.
- Removes the gift when the cart stops matching the condition, so nobody checks out with something they no longer earned.
- Marks gifts in the order and in printed documents, and reports how many went out and what they cost the shop.
- A cancelled order returns its gifts to the campaign's stock.
What it needs
- The products you are ready to give away — ordinary catalogue products with stock.
- At least one tier with a threshold and a list of gifts.
- A cost price on the gift products if you want the report to show what the campaign cost.
What appears in the shop
This is what a shopper sees once it is installed.
- Above the cart items a bar appears saying «350 ₴ left to your gift», so the shopper sees how much to add.
- Below the cart totals a «Your gift» block appears: the gift received, or a choice of the ones available at this order total. The block refreshes together with the cart: add a product and the gifts recalculate without reloading the page.
- On the product page, under the buy button, a «Comes with a gift» note appears with the gift's name and photo.
What’s new
“Gifts” can now be adapted to your shop’s rules. For example, so that the customer picks the gift themselves or can decline it. If you have no such customisation, nothing changes.
What’s new
An order that a manager assembles or edits in the admin panel now gets promotion gifts the same way a customer’s cart does. Before, such an order got no gifts at all. Each promotion appears below the order contents as its own block with the promotion’s name, not as lines among the products. If there are several gifts to choose from, the manager picks them in that block. The blocks update with every change to the order. When the manager adds a product, the gift appears or is replaced by the next tier’s gift, and when the product is removed, the gift goes away. Until the order qualifies for a gift, the block shows how much more to add.
A gift from a promotion that has already ended stays in the placed order and is shown in the “Gifts in the order” block.
Before updating
This version installs only on CartiX 2.128.0 or later. Update CartiX first, then Free gifts.
Fixed
The store no longer gives away a product that won’t be left in stock after the purchase. If there was one pack in stock and the customer put it in the cart at full price, the cart added the same pack again as a gift and promised two when only one was in stock.
Promotion gifts are now added to orders that partners send through the shop API as well. A gift is added only if it’s in stock in the warehouses chosen in the partner’s key, or in the storefront’s warehouses if none are chosen. If the gift isn’t there, the shop accepts the order without it. If the gift is the same product the partner ordered, the gift only gets what’s left after the ordered quantity.
API orders arrived in CartiX 2.119.0. On earlier versions of the shop, the add-on works as before.
What’s new
In the campaign setting “How tiers work”, the options now say plainly whether gifts add up: “Gifts add up: a higher tier adds gifts to those received” and “Gifts do not add up: only the reached tier applies”. Before, the captions did not make this clear. Campaigns work as before.
What we fixed
When a campaign’s tiers replace one another (a bigger total or quantity lets the shopper pick a different gift instead of the one received), the bar above the cart said “Add 5 more to unlock the next gift”. Shoppers expected a second gift and got a choice of another one. The bar now says: “Your gift is in! Add 5 more and you can pick a different gift instead”. Campaigns whose tiers add up keep the old caption.
What we fixed
After the first gift, the “until your gift” bar above the cart filled only halfway: the shopper read “Your gift is in!” while the bar showed half the way. The bar now marks every tier of the campaign: reached tiers are filled completely, and the current one fills up as the shopper adds items. When the gift is given for a quantity or a feature total (for example, a number of tablets), the thresholds are labelled under the marks.
After updating
If you edited the bar template in your theme (the gifts block in the theme editor), reset it to the default to get the new bar.
What’s new
When a shopper is due a gift of their choice, the first gift in the list is now in the cart straight away, and the shopper can swap it in the gifts block. Before, the cart stayed without a gift until the shopper picked one, and an order could leave without the gift it was due.
What we fixed
When a shopper was due two gifts and picked only one, the second disappeared from the cart. The cart now always holds as many gifts as are due: whatever the shopper has not picked is filled in from the list. Clicking a chosen gift again no longer removes it; to change a gift, pick another one.
What’s new
You can now give a gift a price in the promotion settings: the “Gift price” field in the “How many and how they are given” block. Set 0.01, and the gift is sold for a kopeck, which means it appears on the fiscal receipt: the register cannot sell an item priced at zero. The gift price does not affect the promotion threshold. By default the price is 0, and the gift stays free as before.
What we fixed
An order that a manager puts together in the admin panel no longer receives gifts. Before, a gift appeared in such an order on its own, and the next recalculation brought it back as a regular product at the catalog price.
What to do after updating
If you want gifts on the receipt, open your promotions and set a gift price such as 0.01. Check the “Gifts on the receipt” switch on the cash register card: this needs core 2.106.0.
Fixes
The bar above the cart no longer promises a gift the customer already has. Previously, at 10 tablets the gift was already in the cart, yet the bar still said “add 10 more to get a gift”. Now it says “Your gift is in!” and shows how much is left to the next one.
When a gift is due but not chosen yet, the bar says so: “You have earned a gift — pick it below”. When a gift is no longer due — for example, the customer already received it in an earlier order — the bar does not promise it.
The gift picker works even when it appears on the checkout page after the cart changes.
What’s new
The gift list shows shoppers which variant and how much they get: “Viagra 100 — 1 pcs × 2”. The gift’s crossed-out price covers the whole quantity. You choose the gift’s variant and quantity in “Gifts” with shop core 2.99.2.
What we fixed
A gift of a product sold only in packs is added as a whole pack, and the shopper sees exactly that. Before, the list said, say, “× 2” while a pack of six went into the cart and stock was checked for two.
What we fixed
In the cart and at checkout, a gift showed the product’s first photo even when a different variant is given or the photo is meant for another language. A gift now shows the photo of the exact variant being given, in the page language. Requires shop core 2.99.0.
What's new
The gifts block and the “until your gift” progress bar attach their styling together with the page's other files. If a gift appears in the cart after the customer changes a quantity, the block arrives already styled.
The add-on's styling and scripts are now joined with the theme files into a shared compressed file, so the page loads with fewer requests. This works together with core 2.86.0, so the add-on requires it: update the shop first, then the add-on. How joining works: https://cartixx.com/docs/theme/assets
Fixed
When the same gift was listed on two tiers of a campaign, a customer who reached both saw it twice in the choice. Now each gift appears once.
What we fixed
A shopper signed in to their account can pick a gift again. The pick button simply did nothing for them: the shop did not recognise the signed-in shopper on that page and could not find their cart. Only guests took gifts, and the shop owner saw an offer that barely worked.
On a storefront with a language in the address the gift block was redrawn in the shop's default language after a pick. The labels now stay in the shopper's language.
What we fixed
A shopper signed in to their account can pick a gift again. The pick button simply did nothing for them: the shop did not recognise the signed-in shopper on that page and could not find their cart. Only guests took gifts, and the shop owner saw an offer that barely worked.
Подарок, для которого не отмечен ни один товар, больше не сохраняется молча: магазин предупреждает об этом сразу.
The section in the new panel
Gifts are set up in the new control panel. On the left you filter by state — which gifts are being handed out, which are scheduled and which have run out; a list row shows the condition, the number of gifts and how many were given away, and you can switch a gift on or off right there. Gift products are found with the same search the storefront uses.
Gifts for goods sold by the pack
A gift of such a product is given as a whole pack — a shop does not hand out an opened pack even for free. In the «how much is left to add» hint the unit is spelled out, just as on the product page.
An icon of its own
In the «Plugins» section and in the list of installed items the add-on now shows its own icon instead of an identical box, so you find the one you need at a glance. The icon appears on shops running version 1.30.0 and newer.
The gift's price matches what the shopper sees
The add-on reads product prices through the same calculation the rest of the shop uses, so the gift's regular value in the cart and in the list of available gifts matches the storefront price — including when the product has its own currency or a promotion applies to it.
This update requires shop version 1.27.0 or newer.
A gift for quantity, not just for order total
The gift threshold can now be counted by a feature total in the cart. If the shop sells pills, metres or litres, the gift is earned by how many of them add up in total, whatever the pack sizes: “20 pills in total — here is your gift”. The value comes from the SKU, or from the product when the SKU has none; products without that feature do not count towards the threshold.
Tiers now work either way. A higher tier can still add gifts to the lower ones, or you can switch to the opposite — only the reached tier applies. The latter is what you want when tiers are set as ranges (“10–19”, “20–29”): otherwise the top tier would show the shopper everything from the tiers below as well.
Gifts with an order
A gift for the order total with tiers, or for chosen products; the shopper picks it themselves in the cart.