How to Add Free Gifts Automatically to the Cart
The Gifting feature in Dollarlabs Offer Engine allows you to automatically add a free product to the customer’s cart when they purchase a specific product, variant, collection, or any item.
This is perfect for “Buy X, Get Y” promos, freebie campaigns, and quantity-based campaigns.
What the Gifting Feature Does
With gifting, you can set up rules such as:
Buy this product → Automatically receive a free gift in the cart
Scale gifts based on quantity (e.g., buy 3 → get 3 gifts)
Add multiple free gifts
Limit gift quantity using a maximum cap
Show “Free Gift” messaging directly on your product page using our Theme Blocks
Treat a product selection as a grouped requirement (new)
How to Set Up a Gifting Rule
1. Set up an offer in the Offer Engine
Go to your Dollarlabs Discount App
Go to the Offer Engine page
Create a price list if you haven't already
2. Configure the Trigger Product
Inside the pricelist:
Add a new rule
Choose where the rule applies:
A specific product
A variant
A collection
Or any purchase
Example: You select Variant ABC as the product that triggers the gift.
3. Add the Gift Product
Scroll to the Gift Products section:
Click Add Gift Product
Select the product and variant you want to offer as a free gift (example: Product ID 1001)
You can add more than one gift by clicking Add Gift Product again.
Gift Behavior Options
There are now two different behaviors available depending on whether “Consider selection as group of products” is enabled or not.
Behavior 1: Standard Gifting (Checkbox OFF – Previous Behavior)
This is the original gifting behavior.
The selected product(s) act independently.
How it works
If:
Trigger product = Variant ABC
Gift scales with quantity = ON
Then:
Buy 1 → Get 1 gift
Buy 3 → Get 3 gifts
Buy 10 → Get 10 gifts
If scaling is OFF:
Buy 1 or 5 → Get 1 gift
You can also:
Set a maximum cap (e.g., maximum 10 gifts)
Important Note
Previously, gifting worked strictly in a 1:1 logic: Each qualifying product unit directly triggered its corresponding gift unit.
There was no grouped quantity threshold logic.
Behavior 2: Group-Based Gifting (Checkbox ON – New Setting)
Enable:
✅ Consider selection as group of products
When this is enabled, the selected list of products is treated as a group.
The gift is added only when the minimum quantity threshold across the group is met.
Instead of each item triggering a gift individually, the system counts total qualifying items from the rule’s selection.
Quantity From Group
You can define:
Quantity from group → Minimum number of items required from the selected products before a gift is added.
Example:
Rule applies to Collection X
Consider selection as group = ON
Quantity from group = 3
Gift scales with quantity = ON
If a customer adds:
1 item → No gift
2 items → No gift
3 items → 1 gift
6 items → 2 gifts
9 items → 3 gifts
This allows repetition logic such as:
Buy 3 from Collection X → Get 1 gift Buy 6 → Get 2 gifts Buy 9 → Get 3 gifts
This is ideal for bundle-style promotions.
How Group Behavior Works With Scaling
You can combine:
Consider selection as group
Quantity from group threshold
Gift scales with quantity
Maximum cap
Example:
Quantity from group = 3
Gift scales with quantity = ON
Maximum cap = 5
If a customer buys:
15 qualifying items → 5 gifts (capped)
Enable Required Theme Blocks
To make gifting work on your storefront, two theme blocks must be active:
A. Gift Block (Product Page)
Shows the “Free Gift” message on the product page for eligible variants.
B. Code Embed (Cart Logic)
Ensures the gift is automatically added to and synced in the cart.
To enable:
Click Add Block & Activate
Dollarlabs automatically adds the blocks inside your theme
Move the Gift Block where you want it (usually near the variant selector)
Click Save
Once activated correctly, these blocks will show a green status inside the Pricelist editor.
Test the Feature
A. On the Product Page
Switch to the eligible variant — you should see a message like:
“You will receive Product 1001 for free.”
Switch to a non-eligible variant — no gift message will appear.
B. In the Cart
When you add the product(s):
The gift is automatically added as a free line item
If scaling is OFF → gift stays fixed
If scaling is ON → gift quantity updates dynamically
If quantity exceeds max cap → gift remains capped
Adding unrelated variants/products will not affect the gift
For group behavior:
Gift appears only after the defined group threshold is reached
Reducing quantity below threshold automatically removes the gift
Advanced: Using Window Variables (For Custom Themes)
If you prefer to render your own custom gift UI, you can use the global object:
window.DOLLAR_VARIANT_GIFTS
This contains:
All variants for the current product
Whether the variant is eligible
The list of gift products
Quantity scaling data
Group threshold data
Maximum caps
You can use this to design custom gift badges, blocks, or banners.
Current Capabilities
Supported:
Product-based gifting
Variant-based gifting
Collection-based gifting
“Any purchase” gifting
Quantity scaling
Group-based gifting with thresholds
Repetition logic (e.g., Buy 3 → Get 1 repeatedly)
Not yet supported (coming soon):
Cart value–based gifting (e.g., “Spend $100 → Get Gift”)
Need Help?
If you have questions or want us to set this up on your store:
📩 Email us at [email protected] Or just ping us on chat 🙂
Last updated