# 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:\
  \&#xNAN;**“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:\
\&#xNAN;**“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 💪


---

# 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-gift-pro.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.
