Gift system unlocked by quantity or amount, compatible with all bundle types via the gifts mixin.
Progressive Gifts
Progressive gifts allow unlocking free products based on the quantity purchased or the amount spent. This system works with all bundle types via the Gifts Mixin.
Principle
The more the customer buys, the more gifts they receive:
| Threshold | Gift | Status |
|---|---|---|
| 2 units | Travel mini size | Unlocked |
| 3 units | Storage pouch | Unlocked |
| 5 units | Full-size product | Locked |
The customer sees in real time which gifts they have unlocked and how many more they need for the next one.
Activation
Progressive gifts are available in the settings of the following blocks:
- Quantity Bundle (and Mix & Match)
- Variant Bundle
- BOGO Bundle
In the bundle block settings, look for the "Progressive gifts" section:
| Setting | Description | Default |
|---|---|---|
| Enable progressive gifts | Activates the gift system | No |
Display mode
| Setting | Options | Default |
|---|---|---|
| Display | In-card / Below | Below |
In-card (within the tier)
Gifts are displayed directly within each tier card. The customer immediately sees which gift they get with each tier.
| Setting | Description | Default |
|---|---|---|
| Inline style | Images / Text / Both | Images |
| Inline text | Custom text (e.g., "+ {count} FREE gift(s)") | "+ {count} FREE gift(s)" |
| Background color | Accent 1 / Accent 2 / Text | Accent 1 |
Below (underneath)
Gifts are displayed in a separate section below the bundle. This mode offers more configuration options.
| Setting | Description | Default |
|---|---|---|
| Unlock mode | Quantity (by number) / Amount (by amount) | Quantity |
| Progress bar | Shows a visual progress bar | Yes |
| Variant selector | Allows choosing the gift variant | No |
and in Below mode (separate section with progress bar))
Gift configuration
Up to 3 gift levels with increasing thresholds:
Gift 1
| Setting | Description | Default |
|---|---|---|
| Gift product 1 | Shopify product picker | - |
| Quantity threshold | Number of units to unlock (quantity mode) | 2 |
| Amount threshold | Minimum amount to unlock (amount mode) | 50 |
Gift 2
| Setting | Description | Default |
|---|---|---|
| Gift product 2 | Shopify product picker | - |
| Quantity threshold | Number of units to unlock | 3 |
| Amount threshold | Minimum amount to unlock | 80 |
Gift 3
| Setting | Description | Default |
|---|---|---|
| Gift product 3 | Shopify product picker | - |
| Quantity threshold | Number of units to unlock | 5 |
| Amount threshold | Minimum amount to unlock | 120 |
Unlock mode
By quantity
The gift unlocks when the customer selects a tier whose quantity meets or exceeds the threshold:
Tier 1 (1x) → No gift
Tier 2 (2x) → Gift 1 unlocked (threshold: 2)
Tier 3 (3x) → Gifts 1 + 2 unlocked (threshold: 3)By amount
The gift unlocks when the total bundle amount exceeds the threshold:
Total 35 EUR → No gift
Total 55 EUR → Gift 1 unlocked (threshold: 50 EUR)
Total 90 EUR → Gifts 1 + 2 unlocked (threshold: 80 EUR)Progress bar
When enabled (Below mode), the progress bar visually shows:
- Progress toward the next gift
- Already unlocked gifts
- The threshold for the next gift
Gift variant selector
When enabled, the customer can choose the gift variant (e.g., color, size). Useful if the gift is a product with multiple variants.
| Setting | Description | Default |
|---|---|---|
| Variant selector | Allows choosing the gift variant | No |
JavaScript events
The mixin emits an event when gifts are unlocked:
| Event | Description |
|---|---|
bundle:gifts-unlocked | Emitted when a new gift is unlocked, contains the list of active gifts |
Compatibility
| Bundle type | Gift support |
|---|---|
| Quantity Bundle | Yes (in-card + below) |
| Mix & Match Bundle | Yes (in-card + below) |
| Variant Bundle | Yes (in-card + below) |
| BOGO Bundle | Yes (in-card + below) |
| Pack Bundle | Yes (simplified, 1 gift) |
Use cases
Cosmetics - Tiered gifts
- Tier 2x: Travel mini (gift 1)
- Tier 3x: Mini + pouch (gifts 1 + 2)
- Tier 5x: Mini + pouch + full-size product (gifts 1 + 2 + 3)
- Mode: In-card with images
Supplements - Gifts by amount
- 50 EUR: Free shaker
- 80 EUR: Shaker + samples
- 120 EUR: Shaker + samples + nutrition guide
- Mode: Below with progress bar
_gift_tier: true. Make sure your Shopify Discount configuration supports this mechanism so that the gift is actually free at checkout.