# Auto-Add a Gift Product to Cart Based on Discount Code (plus only)

{% hint style="warning" %}
The **Auto-Add Gift to Cart** feature (triggered by coupon codes) is being **deprecated**. Shopify’s recent restrictions on Checkout Extensions make this feature incompatible with their Terms of Service.

**Impact:**

* New configurations cannot be created.
* Existing configurations will continue to work for now, but we recommend reviewing your setup.

**Need help?**\
If you are an existing merchant with active configurations, please contact us at **<support@dollarlabs.io>**. Our team will assist you with managing or transitioning your current setup.
{% endhint %}

This guide shows you how to **automatically add a free gift product** to the cart **when a specific discount code is applied**, using the **Dollarlabs app** on **Shopify Plus**. This is a great way to run “Buy X, Get Y Free” or “Free Gift with Coupon” style promotions - with built-in protection against abuse.

{% embed url="<https://youtu.be/oRti_xHpeIk>" %}

> ⚠️ **Important**: This functionality requires **Shopify Plus** because it uses **Checkout UI Extensions**, which are only available on Plus plans.

{% hint style="warning" %}
This feature should only be used to add products to the cart that do not increase the total order value of the cart. \
\
Ensure compliance with [Shopify's app requirements](https://shopify.dev/docs/apps/launch/app-requirements-checklist#1-prohibited-and-restricted-app-configurations) and is only available to use for Shopify Plus merchants due to [limtiations](https://shopify.dev/docs/api/checkout-ui-extensions).
{% endhint %}

***

#### 🎯 Common Use Case

**Customer enters a discount code → Free product is automatically added to cart**

Example:

> Customer applies code `FREEGIFT` → A ₹50 product is added to their cart for free

***

### 🔧 Setup Guide

#### Step 1: Add the “Auto Add Gift” Block to Checkout

1. In your Shopify admin, go to `Settings → Checkout → Customize` \
   ![](/files/FcpVx5VtwyoWczZnCvyA)
2. If you're on **Shopify Plus**, you’ll be taken to the Checkout Editor.
3. In the left-hand blocks menu, click **“Add app block”**
4. Search for and add:
   * `Auto Add Gift - v1` *(basic version)*
   * or `Auto Add Gift - v2` *(recommended)*

> 💡 **Use v2 for better flexibility**&#x20;

5. Click **Save**

{% hint style="info" %}
If you're using v1 - then you can follow the below screenshot to configure the auto add behaviour.

![](/files/Mu9SbeW5VRGC5ar9jb6s)
{% endhint %}

***

#### Step 2: Configure Gift Logic in the Dollarlabs App

1. Open the **Dollarlabs** app from your Shopify Admin.
2. Go to the **“Auto Add Gift - v2”** section.
3. Create a new rule:
   * **Condition**: Discount code equals `FREEGIFT`
   * **Action**: Add Product ID `xyz` to cart *(the free gift)*

***

#### Step 3: Set Up Discount Code in Shopify Admin

You’ll need to configure a discount that does both Product / Order discount using our [Unified discounts](/dollarlabs-ultimate-discounts/unified-discount-engine-v2.md) feature.

**A. Product Discount (Gift Logic)**

1. Go to Unified Discount  and then `Create Discount`&#x20;
2. Set manual code: `FREEGIFT`
3. Choose:
   * **Buy Conditions**: Create a cart group for the free product&#x20;
   * **Targets**: Target the free product cart group
   * **Quantity limits**: Setup [Max quantity](/dollarlabs-ultimate-discounts/unified-discount-engine-v2/limits/max-quantity.md) from flags and set it to 1

**B. Order Discount (Ensures Discount Code Application)**

1. Enable the [discount class](/dollarlabs-ultimate-discounts/unified-discount-engine-v2/discount-classes.md) for Order discount
2. Set: 0% off and setup conditions if needed.
3. Purpose: This ensures the discount code is recognized at checkout so that the app script can trigger

> 💡 Shopify requires the discount code to be valid in order for the logic to execute.

***

#### 🛡️ Abuse Protection

* **Limit quantity**: Only the specified quantity of gift product will receive discount
* **Auto removal**: If the customer removes the discount code, the gift product is automatically removed from the cart.
* **Only for valid use**: You **can only auto-add free products** via this method (Shopify restriction).

***

#### ✅ Final Test

1. Go to your storefront.
2. Add any product to cart.
3. Apply the discount code `FREEGIFT`.
4. The gift product should appear in the cart with a 100% discount.
5. If the code is removed, the gift product disappears automatically.

***

#### 💬 Still Have Questions?

We’re happy to help.\
Reach out to us via in-app chat or email support at **<support@dollarlabs.com>**.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.dollarlabs.io/dollarlabs-ultimate-discounts/auto-add-a-gift-product-to-cart-based-on-discount-code-plus-only.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.