> For the complete documentation index, see [llms.txt](https://subscriptions-docs.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptions-docs.tech-arms.io/features/free-gift.md).

# Free Gift

Add free gifts to subscription orders, on the first order and on renewal orders, when customers subscribe with the selling plans you choose.

A **free gift campaign** adds free products to your customers' subscription orders. You choose which selling plan options qualify, the minimum the customer must buy, the gift products, and on which orders the gift is sent: the first order, renewal orders, or both.

Use it to welcome new subscribers, reward customers who stay, and give customers a reason to pick a subscription over a one-time purchase.

{% hint style="info" %}
Free Gift is not included in every pricing plan. If the **Free Gift** page shows **Upgrade** or **Contact Us** instead of **Create Gift**, click the button to unlock it.
{% endhint %}

## Create a free gift campaign

{% stepper %}
{% step %}

### Open a new campaign

In the app menu, click **Free Gift**, then **Create Gift**. The **Create Free gift** page opens.

The card on the right shows your progress through the three sections of the form.
{% endstep %}

{% step %}

### Fill in the general information

In **General Information**:

| Field                             | What it does                                                                                                                                       |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                          | The gift name. Customers see it on the product page, and it appears with the product in the cart and at checkout.                                  |
| **Start Date** and **Start Time** | When the campaign starts. Times are set by the hour.                                                                                               |
| **Set end date**                  | Turn on to end the campaign automatically, then choose an **End Date** and **End Time**. Leave it off to run the campaign until you deactivate it. |

![The General Information card with Name, Start Date, and Set end date highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FBYjBT5WuXwJDNGvFWs5I%2Ffree-gift-general-information.png?alt=media)
{% endstep %}

{% step %}

### Choose the plans and the condition

In **Gift Condition**:

**Selling Plan Options**: click **Import existing options** and select the plan options that qualify for the gift.

* You can select up to 5 plan options.
* A plan option can belong to only one campaign. Options already used in another campaign show **Already chosen Gift** and can't be selected.
* Only plan options from your Subscribe & save selling plans are listed. Box plans can't be selected.

**Condition**: choose what the customer must buy to get the gift. Click **Switch** to change the condition type, then enter the value.

| Condition            | The customer gets the gift when                                                                   |
| -------------------- | ------------------------------------------------------------------------------------------------- |
| **Minimum Quantity** | they buy at least this many units of a product with a qualifying plan option.                     |
| **Minimum Value**    | the price of a product with a qualifying plan option reaches this amount, in your store currency. |

The condition is checked for each product in the cart on its own, not for the whole cart. For example, with **Minimum Quantity** 2, a customer who buys 2 units of one product gets the gift, but a customer who buys 1 unit each of two products does not.

**Send free gift(s) after the first delivery**: turn on to also add the gift to renewal orders. See [When customers get the gift](#when-customers-get-the-gift).

* **Start From Cycle**: the first renewal order that gets the gift.
* **Repeat After**: how many cycles to wait before the next gift. **1** means every renewal order.

![The Gift Condition card with the plan options, the condition, and the renewal settings](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2F7hyUFKiYavvOi74oh9Xt%2Ffree-gift-condition.png?alt=media)

{% hint style="info" %}
If you select a prepaid plan option, **Send free gift(s) after the first delivery** is turned off and can't be turned on: "To use free gift per cycle, please remove any prepaid plans."
{% endhint %}
{% endstep %}

{% step %}

### Choose the gift products

In **Gift Product**, search for variants or click **Browse**, and select up to 5 gift variants. Each gift is added as 1 unit.

To let customers choose their gift, turn on **Enable Gift Selection** and set the **Number of selectable gifts**. It must be at least 1 and can't be more than the number of gifts you selected. The card shows, for example, "Customers can select 1 out of 3 gifts."

When gift selection is off, customers get all the gifts you selected.

![The Gift Product card with three gift variants and Enable Gift Selection turned on](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FVJGzhqQzeOeL6oDrs1Wp%2Ffree-gift-product.png?alt=media)
{% endstep %}

{% step %}

### Save and check the campaign

Click **Save**. The campaign is **Active** as soon as it is saved.

Click **Preview** at the top of the page to open the product of the first selected plan option on your storefront. It may take 1–2 minutes for changes to appear on your storefront.
{% endstep %}
{% endstepper %}

## When customers get the gift

| **Send free gift(s) after the first delivery** | First order | Renewal orders                                                           |
| ---------------------------------------------- | ----------- | ------------------------------------------------------------------------ |
| Off                                            | Gift added  | No gift                                                                  |
| On                                             | Gift added  | Gift added from **Start From Cycle**, then every **Repeat After** cycles |

Cycles count renewal orders only. Cycle 1 is the first renewal order, which is the customer's second order.

For example, with **Start From Cycle** 2 and **Repeat After** 3, the customer gets the gift on the first order, then on the 2nd, 5th, 8th renewal order, and so on.

{% hint style="warning" %}

* There is no option to skip the first order. When the condition is met, the first order always gets the gift.
* Renewal gifts are only added to subscriptions created after the campaign was created. Customers who subscribed before do not get renewal gifts from it.
* Prepaid subscriptions never get renewal gifts.
* Renewal gifts are available on some pricing plans only. If renewal orders don't get the gift even though the conditions are met, contact us to check your plan.
  {% endhint %}

## What customers see

**On the product page**, when the customer selects a qualifying plan option, a free gift section appears under the subscription widget with:

* a **Free Gift** label and the gift **Name**,
* the condition, for example "🎁 Get gift on orders from 2 items on first delivery",
* the gift products. With gift selection on, customers pick their gifts with radio buttons (1 gift) or checkboxes (2 or more), and see "You can select up to N gift(s)". The first gifts in your list are selected for them.

**In the cart**, the gift is added as a separate product when the condition is met, and removed when it is no longer met. This also works with the **Buy it now** button. If a gift is out of stock, the customer sees a "Gift unavailable" message.

**At checkout**, the gift is free. The discount shows the gift **Name**.

**On renewal orders**, the gift is added to the subscription's upcoming order as a free product.

![The product page with the free gift section under the subscription widget](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FIuoyNarYZPFkKYe5Y5v2%2Ffree-gift-storefront-product.png?alt=media)

{% hint style="info" %}
The texts in the free gift section on the product page can't be changed or translated in the app. Contact us if you need to change them.
{% endhint %}

## Edit, deactivate, or delete a campaign

* **Edit**: in the **Free Gift** list, click a campaign, make your changes, and click **Save**.
* **Deactivate**: open the campaign and click **Deactivate**. Click **Activate** to turn it back on.
* **Delete**: in the list, click the delete icon on the campaign row and confirm. This can't be undone.

{% hint style="warning" %}
Changes don't apply right away to renewal gifts. The gift for a subscription's next renewal order is already added to that order, so your changes apply from the gift after it.
{% endhint %}

## Limits

* **Up to 5 plan options and 5 gift variants** per campaign.
* **One campaign per plan option.**
* **No gifts with Quick Checkout Link.** First-order gifts are not added to orders placed through a [Quick Checkout Link](https://subscriptions-docs.tech-arms.io/features/email-notifications/quick-checkout-link.md).
* **No gifts for boxes.** [Build-A-Box](https://subscriptions-docs.tech-arms.io/features/build-a-box.md) plans can't be selected.
* **Don't turn off the app's discount.** Gifts are made free by the automatic discount **TA SUBSCRIPTIONS APP SELLING PLAN DISCOUNT** (on older stores: **EASTO SELLING PLAN DISCOUNT**) in **Shopify admin > Discounts**. If you turn it off, customers are charged for the gift.

## Good to know

* The gift name you enter in **Name** is visible to customers. Use a short, friendly name, for example "Free sample with your first box".
* Test the campaign in your store before you announce it: add a product with a qualifying plan option to the cart and check that the gift appears.

*If you need help, feel free to reach out to us via in-app* [***Live chat***](https://go.crisp.chat/chat/embed/?website_id=c4ae10a3-f762-4968-b35a-c931caf62a96)***,*** [***Book a call***](https://calendly.com/ta-subscription-app-support/30min) *or at* [***support@tech-arms.io***](mailto:support@tech-arms.io)***.***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://subscriptions-docs.tech-arms.io/features/free-gift.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
