Buy X Get Y (BXGY)

This document explains all configuration fields and setup steps inside the Buy X Get Y (BXGY) tab of the CartLift app.
Note: In the screenshot above, only the Buy X Get Y (BXGY) tab is active. All other tabs are blurred to maintain focus on this section.
1. Overview of Buy X Get Y (BXGY)
The BXGY feature allows merchants to create quantity-based promotional offers such as 'Buy 3 Get 1 Free'.
This strategy increases cart size by encouraging customers to purchase more items to unlock a reward.
2. Step-by-Step Field Explanation
Step 1: Add Rule
Click 'Add Rule' to create a new Buy X Get Y promotion.
Step 2: Enable Toggle

Enable checkbox activates or deactivates the BXGY campaign.
Step 3: Buy (X qty)
Define how many units a customer must purchase to qualify for the offer.
Example: 3 means customer must buy 3 products.
Example: 3 means customer must buy 3 products.
Step 4: Get (Y qty)
Define how many units the customer will receive as free or discounted.
Example: 1 means customer gets 1 item free.
Example: 1 means customer gets 1 item free.
Step 5: Maximum Uses per Order
Limit how many times the offer can be applied in a single order.
Example: 2 means customer can unlock offer twice.
Example: 2 means customer can unlock offer twice.
Step 6: Scope
Choose where the offer applies:
- All products
- Specific products
- Collections
Step 7: Apply – Choose Products
Select specific products eligible for the BXGY promotion if scope is limited.
Step 8: Rule Icon
Select an icon (e.g., Sparkles ✨) displayed near the promotional message.
3. Content Settings Section

Before Offer Unlock Message
Displayed before the required quantity is reached.
Supports dynamic variables:
Supports dynamic variables:
- {{x}} – Required quantity to buy
- {{y}} – Quantity customer receives
Example:
Add {{x}} more items to get {{y}} free
Add {{x}} more items to get {{y}} free
After Offer Unlock Message
Displayed once the customer qualifies for the offer.
Example:
Congratulations! You've earned a free item 🎉
Congratulations! You've earned a free item 🎉
Campaign Name
Internal campaign name used for tracking and analytics.
Save Rule
Click 'Save Rule' to activate and apply the BXGY configuration.
4. Preview Panel Explanation
The BXGY tab uses real-time preview messaging in the cart drawer.
Customers see quantity-based progress and unlock notifications dynamically.
5. Related Shipping Types (Reference)
Shipping Rules tab supports two reward types:
These are configured separately under the Shipping Rules section.
- Free Shipping
- Reduced Shipping
These are configured separately under the Shipping Rules section.
6. Best Practices
- Use simple offers like Buy 2 Get 1 for better clarity.
- Highlight savings clearly in messaging.
- Combine with Free Shipping to maximize conversions.
- Set reasonable usage limits to protect margins.
