> ## Documentation Index > Fetch the complete documentation index at: https://aiodapp.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Tiered free gifts > Template for unlocking a different free gift at each spend or quantity level, such as Spend $50 get Gift A and Spend $100 get Gift B, with a tiered gift widget. Use **Tiered free gifts** when a merchant wants customers to unlock more or better gifts as they spend more or buy more. The template card says: "Unlock more gifts as customers buy more. Spend $50 -> Gift A, Spend $100 -> Gift B)". Its tags are **Free Gift**, **Gift Widget**, and **Tiered Offer**. ## When to use this template Use this template for: * Spend `$50`, get Gift A. Spend `$100`, get Gift B. * Buy 3 items, get one gift. Buy 6 items, get a bigger gift. * Gift ladders, gift-with-purchase tiers, or "spend more, unlock more gifts" offers. * Tiered gifts that customers choose from a gift widget, one set of choices per tier. * Tiered gifts at a special discounted price instead of fully free. Use another template when: * One gift unlocks at one threshold. Use [Free Gift with Purchase](https://aiodapp.com/docs/templates/free-gift-with-purchase.md) (the **Simple free gifts** card). * Tiers mix gifts with percentage, fixed-amount, or shipping rewards. Use [Tiered Discount](https://aiodapp.com/docs/templates/tiered-volume-discount.md), where each tier's **Customer gets** can be **Free gift**. * The gift depends on buying specific X items. Use [Buy X Get Y (Gift)](https://aiodapp.com/docs/templates/buy-x-get-y-gift.md). ## Entry point In Shopify admin, open **Apps** > **AIOD Discount & Gift** > **Discount Templates**. 1. Click **Create** on the **Free gifts** card. 2. AIOD opens a **Select type** page with two inner templates: | Inner template | Opens | | - | - | | **Simple free gifts** | The **Free Gift** form. Read [Free Gift with Purchase](https://aiodapp.com/docs/templates/free-gift-with-purchase.md). | | **Tiered free gifts** | A form titled **Tiered free gifts**. This page documents it. | 3. Click **Tiered free gifts**. **Tiered free gifts** uses the same editor as [Tiered Discount](https://aiodapp.com/docs/templates/tiered-volume-discount.md), restricted to gift rewards. A saved tiered free gift opens in the **Tiered free gifts** form again. ## Top-level controls The form has three tabs: | Tab | What it controls | | - | - | | **Offer** | What the tiers are based on, each tier's threshold and gifts, the gift adding method, reward behavior, discount method, title, and schedule. | | **Advance Settings** | Customer eligibility, markets, offer-wide conditions, combinations, sales channel, offer pricing, and cart refresh and behavior. | | **Gift Widget** | The storefront tiered gift widget. It is always on for this template. | There is no **Progress Bar Widget** tab. The tiered progress bar used by **Tiered Discount** is not available on this template. AIOD can show a theme-extension alert at the top of the form. The merchant must enable and save the **Latest Widget Manager** app embed in the theme editor for the gift widget to appear on the storefront. ### Status mode The top-right status dropdown controls who can use or see the discount. | Status | Meaning | | - | - | | **Active** | The discount is live for customers. | | **Testing mode** | The discount is visible to the merchant for testing, but it is not live for customers. | | **Deactivate** | The discount is turned off. | The create form shows only **Active** and **Testing mode**. **Deactivate** becomes available after the discount is saved. ## Offer settings ### Tiers Based On? This card sets what every tier's threshold measures. It reads as one sentence: "Gift Tiers are calculated based on \[**Quantity** or **Purchase amount**] of \[**All products**, **Specific products**, **Specific collections**, or **Specific variants**] in the cart." | First dropdown | Second dropdown | Tiers unlock on | | - | - | - | | **Quantity** | **All products** | The total number of items in the cart. | | **Quantity** | **Specific products**, **Specific collections**, or **Specific variants** | The quantity of the selected items in the cart. | | **Purchase amount** | **All products** | The cart subtotal. | | **Purchase amount** | **Specific products**, **Specific collections**, or **Specific variants** | The subtotal of the selected items in the cart. | **Purchase amount** of **All products** is the default for a new tiered free gift. Choosing a specific option reveals a picker below the sentence. Select at least one product, collection, or variant. Saving with an empty picker shows an error such as `Select at least one product.` The selected items count toward the threshold in total, across all selected items. This template does not show the **Calculation method** card or **Exclude items (optional)** that **Tiered Discount** shows. ### Consider subtotal When tiers are based on **Purchase amount**, AIOD shows **Consider subtotal**: | Option | Behavior | | - | - | | **Before discount** | Tier progress uses item prices before any discounts are applied. | | **After discount** | Tier progress uses item prices after all discounts are applied. Progress can change when other discounts are added to or removed from the cart. | Choosing **After discount** forces **Stack all unlocked tiers** under **Reward behavior**. ### Set up your discount tiers Each tier has: | Field | Behavior | | - | - | | **Minimum Quantity** or **Minimum Subtotal** | The threshold for the tier. The label follows **Tiers Based On?**. | | **Free gift quantity** | How many gifts the tier gives. Required. | | **Select Gift items** | The gift variants for this tier. AIOD asks that gift variants are active, in stock, and priced above `0`. | | **Discount Message (optional)** | Customer-facing message shown when the tier is met. Shown only when the discount method is **Automatic**. Variables are not allowed. | Every tier is a gift tier. The **Customer gets** dropdown that **Tiered Discount** shows is hidden here. Click **Add another tier** to add more tiers. Every tier after **Tier 1** has a delete button. ### Gift adding method This card controls how each tier's gifts reach the cart. The options depend on **How should this discount be applied?** further down the **Offer** tab. | Method | Discount method | Behavior | | - | - | - | | **Auto-added** | **Automatic** | AIOD adds the tier's gifts automatically when the customer qualifies. | | **Customer chooses** | **Automatic** | Customers pick their gifts from the gift widget. | | **Trigger with discount code** | **Discount code** | Gifts are added only after the customer enters the code. | | **Code + customer chooses** | **Discount code** | Customers enter the code first, then claim gifts from the widget. | On a new discount, the two options of the other discount method are listed but disabled. Their tooltip tells the merchant to switch **How should this discount be applied?** first. After the discount is saved, only the current discount method's two options are shown. With **Customer chooses** or **Code + customer chooses**: * The customer claims gifts separately for each unlocked tier. Each tier's **Free gift quantity** limits how many gifts the customer can claim from that tier. * In checkout, the AIOD gift claim lists the gifts under a heading per tier, such as **Tier 1**, when several tiers are unlocked. * If the cart drops below a tier's threshold, AIOD removes the gift claimed for that tier. > [!NOTE] > > A tiered discount with a customer-choice gift method saved before October 22, 2026 needs to be opened and saved once. Until then, a gift claimed in checkout can be charged at full price. ### Reward behavior | Option | Behavior | | - | - | | **Only highest unlocked tier** | Only the highest reached tier's gifts apply. This is the default for a new tiered free gift. | | **Stack all unlocked tiers** | Every unlocked tier's gifts apply. | With **Only highest unlocked tier** and a customer-choice method, reaching a higher tier removes a gift the customer claimed from a lower tier. The gift stays when **Auto remove** is off or the gift widget's **Don't Remove Invalid Claimed Items** is checked. When **Stack all unlocked tiers** is selected, AIOD also shows [**Move overlapping tier discounts to other eligible items**](https://aiodapp.com/docs/app/common-template-settings.md#move-overlapping-tier-discounts-to-other-eligible-items) and its nested option **Don't count discounted items toward later tiers**. ### Discount method **How should this discount be applied?** offers **Automatic** and **Discount code**, as on [Tiered Discount](https://aiodapp.com/docs/templates/tiered-volume-discount.md#discount-method). The method cannot be changed after the discount is saved. **Automatic** shows **Title**. **Discount code** shows the code field, code generation, bulk codes, and usage limits. Code-based gifts need the **AIOD Discount Input** widget. Read [Discount Code Input](https://aiodapp.com/docs/app/discount-widgets.md#discount-code-input). ### Schedule Choose **Run continuously** or **Set a schedule**. **Set a schedule** shows **Start date**, **Start time**, **End date**, and **End time**. ## Advance Settings The **Advance Settings** tab shows these cards, in this order: * **Customer eligibility**: **All customers** or **Specific customers**. * **Markets**: **All markets**, **All markets except specific selected countries**, or **Specific selected countries**. * **Offer-Wide Conditions**: Extra conditions that must be met for the offer to apply. * Combinations. Read the section below. * **Sales channel**: **Online store**, **POS**, and **Tapcart mobile app** once Tapcart is on. Read [**Sales channel**](https://aiodapp.com/docs/app/common-template-settings.md#sales-channel). * **Offer pricing**. * **Cart refresh and behavior**. This template hides **Quantity Limits**, **Purchase Type eligibility**, and **Discount exclusions**. Gift quantity is set per tier on the **Offer** tab. ### How should this discount combine with other discounts? Read [**This discount can be combined with**](https://aiodapp.com/docs/app/common-template-settings.md#this-discount-can-be-combined-with) for information about this. ### Offer pricing **Offer pricing** chooses whether the gifts are free or discounted. It works as on [Free Gift with Purchase](https://aiodapp.com/docs/templates/free-gift-with-purchase.md#offer-pricing): * **Offer as free gift**. This is the default. * **Offer at a discounted price**. Reveals **Discount percentage** (`%`). AIOD fills `50` when the merchant switches to it. * **Exclude AIOD-attributed items from condition calculation**. One price covers every gift tier. Changing it updates all tiers, and a new tier takes the same price. ### Cart refresh and behavior **Cart refresh and behavior** works as on [Free Gift with Purchase](https://aiodapp.com/docs/templates/free-gift-with-purchase.md#cart-refresh-and-behavior): | Setting | Behavior | | - | - | | **Auto remove** | Removes gifts when the customer is no longer eligible. On by default for a new tiered free gift. | | **Allow gift opt-out** | Lets customers remove an added gift from the cart. Shown only for **Auto-added** and **Trigger with discount code**. | With **Allow gift opt-out**, a gift the customer removed stays removed while any tier of the discount is still unlocked. It is not added back just because the customer has not reached a higher tier. The card also shows the **Instant cart refresh** notice. If the side cart drawer does not refresh when a gift is added or removed, contact support. ## Gift Widget The **Gift Widget** tab configures the storefront tiered gift widget. On this template the widget is always enabled, and there is no enable checkbox. The widget shows one panel per tier. On the storefront it opens on the highest tier the cart has reached, and on **Tier 1** before the first threshold is reached. With a customer-choice method, customers claim gifts from this widget. The widget's placement and preview appear in the right-hand column of this tab. A new widget is placed on the cart page. ## Save Click **Save** after configuring the tiers, gift adding method, advanced settings, gift widget, status, and schedule. ## AI answering guidance When an AI answers a merchant question about this template: * Use **Tiered free gifts** as the template name. It is an inner template under the **Free gifts** card. * Ask whether tiers are based on **Quantity** or **Purchase amount**, and of which items. * Ask for each tier's threshold, gift variants, and **Free gift quantity**. * Ask whether gifts are auto-added or chosen by the customer, and whether a discount code is required. * Ask whether only the highest tier's gifts apply or all unlocked tiers' gifts. * Use [Tiered Discount](https://aiodapp.com/docs/templates/tiered-volume-discount.md) instead when any tier needs a non-gift reward. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.