---
title: Every setting on the Free gift page, explained
description: 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.
canonical: https://tacey.app/docs/free-gift/every-setting-on-the-free-gift-page
updated: 2026-11-20T07:16:30.584Z
---
# Every setting on the Free gift page, explained

**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 says | What it means | What 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 page | Press **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 yet | Nothing. 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 items | Nothing. 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 see | What it means | What to do |
|---|---|---|
| A note beside a gift: sold out or not for sale | That gift cannot be offered right now | Restock 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 left | Replace 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 extra | Choose 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 in | Turn 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 gift | Choose 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 most | Move 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?](/docs/free-gift/free-gift-not-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

- [How does the free gift work for customers?](/docs/free-gift/how-the-free-gift-works-for-customers)
- [How do I offer a free gift after checkout?](/docs/free-gift/offer-a-free-gift-after-checkout)

## Still stuck?

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