Skip to the article

Every setting on the Free gift page, explained

What each Free gift setting does, its default, what your customer sees, how gift tiers and import duties work, and what to check when no gift shows.

Odera Joseph, FounderWritten by Odera JosephFounderUpdated
View as Markdown
Ask AI

Send the Markdown address of this page to an assistant.

Open in ChatGPTOpen in PerplexityOpen in Grok

In short: Free gift shows a customer a choice of gifts on their order page, based on how much their order came to. They claim one, and it is added to the order at no charge. This page has 17 settings. With no tier set, no gift is offered, so nothing shows until you add at least one tier.

Before you start

  • Customer editing must be on. Turn on Let customers edit their own order under Editing Tools, then Global settings. It is off on a new store.
  • The tool must be on. Open Editing Tools and check Free gift is turned on.
  • The Tacey block must be placed in Shopify's checkout editor (Thank you page) and the customer accounts editor (Order status page). Shopify does not let Tacey see whether you did.
  • Order type matters. A gift is added to the order, so Shop Pay Installments, other-app, pending-payment, pre-2019, local delivery and B2B orders are refused.
  • Money. A gift is added at no charge. The one exception is an import duty on a cross-border order: see Orders that ship to another country below.

How to open the settings

Open Editing Tools, choose Free gift, then Configure, change what you need and save.

What your customer sees

A row of gift cards, each with a button (Claim now unless you change it). They tap one, and it is added to their order.

  • A line naming the tier. When your ladder has more than one tier, each card carries a line saying which tier unlocked it, for example "Unlocked at $100.00", in your store's currency and in your customer's language. A store with a single tier shows no line, so its cards read as before.
  • Six cards, then Show more. A tray with more than six gifts shows six cards and a count such as "Showing 6 of 15 gifts", with a button such as Show 9 more gifts that reveals the rest.
  • At most 15 gifts are drawn. If the order has unlocked more than 15, the highest tiers are kept first and the rest are left out of the tray. This only limits what is drawn: it does not change which gifts the order has unlocked.
  • Placement first. The cards appear only where the Tacey block is placed, or under the item list if you chose that in Where it shows below.

Check one test order on your own store after you add a second tier.

Every setting

Gift tiers

Default: none. Each tier starts at an order amount and offers its own gifts. The amount is the subtotal your customer sees on their order, after discounts and before shipping, in your store's currency whatever currency they pay in; tax is counted only if your prices include tax. A gift stays on an order once a customer has chosen it, even if the order total later goes down. A customer whose order reaches a tier can choose one gift from that tier and the tiers below it. Empty tiers are ignored. With no tier, no gift is offered. Recommended: two or three tiers at amounts your average order already reaches, so some customers see a gift and a few are tempted to spend more next time.

Customers also see gifts from lower tiers

Default: on.

  • On: a customer who reaches tier 2 chooses from tier 1 and tier 2 gifts.
  • Off: they see only the gifts of the highest tier their order reached.

Either way each claim adds one gift. Recommended: on.

Gifts per order

Default: 1, from 1 to 10. How many free gifts one order may carry. Each claim adds one gift, and a customer can claim again until the order carries this many. Recommended: 1. Each gift is stock you give away.

Gift button text

Default: empty. The word on the button of each gift card. Customers see "Claim now" unless you add your own words for a language here. A language you leave out reads "Claim now" in that customer's language.

Where it shows

Default: In the order changes box. Where the gift cards appear on your customer's page. They show in one place only, never both. Under the item list puts them beneath the order's items on the thank you and order status pages. On a phone, Shopify may fold the order summary away, which would hide them there. Under the item list needs a step in Shopify: add Tacey items slot to each page in the checkout editor (Settings, Checkout, Customize, then Add block, Tacey items slot, Save). It is a separate row from Tacey editing tools, and both can be on the same page. Until Tacey sees a customer open the page with the slot on it, the gifts keep showing in the order changes box, so your customers never lose them.

When you choose Under the item list, a note appears right under the choice, with one line per page (Thank you page, Order status page):

What the note saysWhat it meansWhat to do
"Not added yet. Until you add it, this keeps showing in the order changes box."Tacey has not seen the slot on that pagePress Add the items slot: it opens the checkout editor on that page with the apps panel open. Add the block, Save, then reload the Tacey page
"Added. Waiting for the first customer to open the page."The slot is on the page, and no customer has loaded it yetNothing. The gifts stay in the order changes box until a customer opens the page. (Tacey shows this line only when Shopify itself reports the slot placed; until then the note reads "Not added yet" until the first customer opens the page)
"Showing under your items. Last seen {when}."A customer opened the page with the slot on it, so the gifts moved under the itemsNothing. If you remove the slot, no customer will open a page with it on, and after 14 days without a customer the note goes back to "Not added yet"

Tacey reads your saved checkout, so a change you have not saved in the editor is not counted. Recommended: keep the default unless you want the gifts right under the items, and check the page on a phone after you change it.

Orders that ship to another country

Default: Offer the gift and tell the customer and me if money is owed. Shopify can add an import duty to a gift when it is added, so a gift advertised at no charge can leave the order owing money. Orders that already carry a duty are never offered a gift. On an order that crosses a border and carries no duty yet, the customer is told before they claim the gift that Shopify may add a duty.

  • Offer the gift and tell the customer and me if money is owed: the gift is offered. If Shopify adds a charge when the gift is added, the customer is told the amount on the page, and the edit feed and the order's record say the order now owes money. Nothing is charged or refunded for you.
  • Do not offer a gift on orders that ship to another country: no gift is shown, and none can be added, on an order whose destination country differs from the country it ships from. If we cannot read either country, no gift is offered.

Recommended: the second choice if you never want a gift to cost a customer a duty.

Heading above the gifts, Sub-heading, "Unlocked at" words and "Free" badge

Default: empty, so customers read Tacey's own words in their language. Each of these four settings holds your own words for one language at a time. Press Add a language, pick the language, and type the words. A language you leave out keeps Tacey's words, translated, and a blank row stores nothing. The words are plain text: angle brackets are removed and the length is capped (80 characters for the heading, 160 for the sub-heading, 60 for the "unlocked at" words, 20 for the badge).

  • Heading above the gifts: the heading over the gift cards. Customers see "Free gift" unless you write your own.
  • Sub-heading: one line under the heading, for example the terms of the offer. Empty shows none.
  • "Unlocked at" words: the line on a gift card that says which tier unlocked it. Write {amount} where the tier's amount should appear, for example "Unlocked at {amount}". A tier you gave its own name shows that name instead. A store with one tier shows no line at all.
  • "Free" badge: a badge on each gift card. It shows only in the languages where you wrote a word.

Layout

Default: Carousel. How the gifts are laid out, for every tier. Carousel slides the gifts in pages, Grid shows them side by side, and List shows one gift per row with the picture beside the details, which reads best on a phone. Recommended: keep the carousel unless you offer only a few gifts, then try the grid, and check the page on a phone.

Show the gift's normal price

Default: on. Shows the gift's own price crossed out beside its price of zero. Turn it off to show only the free gift.

A gift that is sold out

Default: Hide it. Hide it keeps a sold-out gift off the page. Show it as sold out draws the card with "Sold out" and no button. A sold-out gift can never be claimed either way, and if every gift is sold out and you chose to hide them, nothing shows.

Gifts start on and Gifts end on

Default: empty, so gifts run all the time. Use these to run your gifts for set dates only, for example a Black Friday ladder. Pick a date and a time in your store's timezone. Before the start and from the end, nothing shows, and a customer cannot claim a gift either, even one who had the page open before the end. The start counts from the minute you pick and the end stops it from the minute you pick. The page tells you next to the setting when the gifts are scheduled for later or have ended. If the start cannot be read, your gifts are held back until you fix it, so a typo never turns a scheduled ladder on early. An end that cannot be read means no end. An end that is not after the start can never open, and the page says so.

Tell customers how far the next tier is

Default: off. Adds a line such as "Spend $20.00 more to unlock Gold" under the gifts. It shows only to a customer who has already unlocked a tier and has a higher tier to reach, in your store's currency and the customer's language, and it never names a gift they have not unlocked. It stays hidden with only one tier, and it does not show to a customer who has not reached the first tier yet.

Only show the gifts to orders where

Default: no conditions, so every order that qualifies sees the gifts. Add a condition to show the gifts only to some orders: the shipping country (two-letter codes such as US or CA), the shipping method, the order tags, the sales channel or the product tags of what is on the order. Each condition is "any of" or "none of" a list of values you type, separated by commas (for tags, "has any of" or "has none of"). Every condition you add must be true. A customer whose order does not match sees nothing, and cannot claim a gift with a copied link either: the order is checked again when they confirm. Tags and words are not case sensitive.

An order that is missing what a condition needs does not match it, and that includes "none of". A digital order has no shipping address, so it never matches a country condition. An order with more than one shipping method never matches a shipping method condition, because Tacey will not guess which one you meant. A product tag condition looks at the products still on the order. A condition can only narrow who sees the gifts: it never shows a gift on an order that is not allowed one, never lifts Gifts per order, and never unlocks a tier the order total did not reach. The page tells you next to a condition when no order can match it (no value, or two conditions that cannot both be true). Customer conditions (first order or returning, customer tags), discount codes and collections are not available yet.

What this page tells you while you edit

Beside the schedule and the "spend more" line the page says in plain words when they cannot show: "Scheduled for ..., until then nothing shows and no gift can be claimed", "This ended on ...", "This start time could not be read, so your gifts are held back", and that the "spend more" line needs a tier above the one a customer reached.

Under the tier editor the page says in plain words when your ladder cannot give a gift. Nothing is saved differently because of these notes. They read what Shopify says about each product: sold out, not for sale, a draft or archived product, or published to no sales channel.

What you seeWhat it meansWhat to do
A note beside a gift: sold out or not for saleThat gift cannot be offered right nowRestock it, put it on a sales channel or choose another gift
"{count} of the {total} gifts in tier {number} are sold out, not for sale or not available to customers, so they are skipped."The tier still works with the gifts leftReplace the skipped gifts if you want the full choice
"Every gift in tier {number} is sold out, not for sale or not available to customers, so this tier adds nothing. Customers who reach it still choose from the tiers below."The tier gives nothing extraChoose gifts for it that are in stock
"An order that reaches tier {number} is offered no gift right now, because every gift it could choose from is sold out, not for sale or not available to customers."Customers also see gifts from lower tiers is off, so the tiers below cannot fill inTurn that setting on, or restock the tier's gifts
"This gift ladder is on, but it cannot give a gift right now: every gift in every tier is sold out, not for sale or not available to customers."No customer will be offered a giftChoose gifts that are in stock and on a sales channel
"Your top tier offers {gifts} gifts, but the tray draws 15. Customers see the highest tiers first and the rest are left out of the tray."The tray draws 15 gifts at mostMove some gifts down a tier or remove a few

A tier that no real order has reached yet is not flagged.

How the settings work together

  • Tiers and lower-tier visibility decide what is shown; gifts per order decides how many can be claimed.
  • Stock and locations: a gift is subject to your Add a product Locations an added item may ship from and Allow adding items after the whole order has shipped settings.
  • The duty choice can hide the whole row on a cross-border order.

If it does not work

No gift shows.

  1. Check the Tacey block is placed.
  2. Check Let customers edit their own order is on in Global settings.
  3. Check Free gift is on in Editing Tools.
  4. Check you added at least one tier with at least one gift.
  5. Check the order total reached the first tier.
  6. Check the order does not cross a border with Do not offer a gift on orders that ship to another country chosen, and already carries no duty.
  7. Check the edit window, the order type, and that the order has not fully shipped with Allow adding items after the whole order has shipped off.

The customer sees "That gift is out of stock right now" or "not available at the moment". The gift is out of stock or unavailable (E0031, E0032).

The customer sees "That item is already on your order, so it can't be added again as a gift." (E0067).

More: Why isn't my free gift showing?.

What this does not do

  • It does not charge for the gift, except for an import duty Shopify may add.
  • It does not offer a gift on an order that already carries a duty.

Learn more

Still stuck?

Contact Tacey support from the chat bubble inside the Tacey app, or email hello@taceysupport.app.

Was this helpful?

One tap tells us whether this article did its job.

For AI agents: this article as markdownthe whole help centerllms.txt