> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarlabs-ultimate-discounts/auto-add-gift-pro.md).

# Auto-Add Gift Pro

AutoAddGift Pro lets Shopify Plus brands **automatically add free gifts, upsells, or upgrade products at checkout** based on predefined rules. These rules run directly at checkout and ensure gifts are only added when your conditions are met.

This feature is ideal for:

* Free gift with purchase campaigns
* Checkout upsells
* Product upgrades or downgrades
* Birthday surprise gifts

{% embed url="<https://dollarlabs.neetorecord.com/watch/ed8328f08e265f4f393a>" %}

***

### How AutoAddGift Pro Works

AutoAddGift Pro automatically adds (or removes) a gift product at checkout based on **triggers** and **conditions** you configure in the app.

#### Supported Triggers

There are **three ways** a gift can be triggered:

***

### Discount Code Trigger

A gift is added only when a specific discount code is applied.

#### How it works

* A unique discount code is created / you can set the code when you save the rule
* Only this code will trigger the gift
* The discount code is validated against your configured conditions
* If conditions are not met → the discount code is rejected
* If conditions are met → the gift product is added automatically

#### ✅ New: Optional Order Discount Support

You can now optionally apply an **order-level discount** when this code is used.

This means the same code can:

* Add a free gift
* Apply a percentage or fixed order discount
* Do both together

For example:

* Use code **GIFT10**
* Customer meets the conditions
* A free gift is added
* A 10% order discount is also applied to the cart

You can configure:

* Discount type (Percentage / Fixed amount)
* Discount value

If you set the discount value to 0%, the code will only trigger the gift (no price reduction).

This makes it perfect for:

* “Free gift + 10% off” campaigns
* VIP promotion codes
* Influencer-driven promotions
* Birthday gift + special discount combinations

Use this trigger when you want a gift tied strictly to a promotion code — optionally combined with an order discount.

***

### Automatic Condition-Based Trigger

* No discount code required
* When cart conditions are met, the gift is added automatically
* Conditions can include:
  * Product collections
  * Subtotal thresholds
  * Quantity rules
  * Custom combinations of conditions

This is ideal for “Free gift on orders above ₹X” type campaigns.

***

### Customer Birthday Trigger

* Uses a **customer metafield** containing the customer’s birthday
* If the checkout date matches the customer’s birthday:
  * A gift is automatically added
  * Conditions you configure still apply (order value, products, etc.)

Perfect for loyalty and retention programs.

***

### Example: Free Gift on Hydrogen Collection Orders

Let’s walk through a simple example.

#### Goal

Add a free gift **only if**:

* Products are from the *Hydrogen* collection
* Subtotal of Hydrogen products is **greater than ₹10,000**

***

#### Step 1: Configure the Gift Rule

1. Select the **gift product** you want to add
2. Set conditions:
   * Collection = Hydrogen
   * Subtotal (of Hydrogen items) > ₹10,000
3. Configure messaging:
   * **Checkout banner title** → shown at checkout
   * **Checkout banner description** → shown at checkout
   * **Gift message** → shown on the gift line item
4. Set an **internal title** (for admin reference only)

Once saved, this rule defines *when* the gift should appear.

***

#### Step 2: Enable the AutoAddGift Pro Checkout Block

This step is mandatory.

1. Go to **Online Store → Themes**
2. Click **Edit theme**
3. Navigate to **Checkout and customer accounts**
4. Add and enable the **AutoAddGift Pro** block

> This block handles:
>
> * Adding the gift
> * Validating conditions
> * Displaying checkout messaging

If the block is not enabled, the gift will **not** be added.

***

#### Step 3: Test the Setup

* Add eligible Hydrogen products to cart
* Go to checkout:
  * If subtotal is **below ₹10,000**, no gift is added
  * If subtotal is **above ₹10,000**, the gift is added automatically
* A checkout banner confirms:\
  **“A free gift has been added to your order.”**

***

### Auto-Remove Gift When Conditions Change

AutoAddGift Pro can also **remove gifts automatically**.

#### How it works:

* If a customer removes items
* And the cart no longer meets the conditions
* The gift product is automatically removed from the cart

This behavior is controlled by the setting:\
**“Auto remove gift when conditions are no longer met”**

This ensures gifts are never abused or left behind incorrectly.

***

### Switching Between Triggers

At any time, you can change the trigger type to:

* Discount code–based
* Automatic condition–based
* Customer birthday–based

The same gift and conditions framework applies across all triggers.

***

### What’s Coming Next

Upcoming enhancements include:

* **Manual gift selection**
  * Instead of auto-adding a gift
  * Customers choose from a curated list of gift products at checkout
* More flexibility for advanced checkout strategies

***

### Need Help?

If you have questions or want help setting this up:

* Use the in-app chat widget
* Email us at **<support@dollarlabs.io>**

We’ve got you covered 💪