Free Gift
The Free Gift feature allows you to reward customers with free or discounted products when they meet specific purchase conditions.
1. General Settings
1.1 Rule Name
Set a name for your Free Gift rule. This is for internal management only and will not be shown to customers.
1.2 Status
Choose whether the rule is active or inactive.
Only active rules will work on your storefront.
1.3 Validate offer
The Validate Offer button helps you check whether your Free Gift setup is correctly configured and ready to work on your storefront.
When clicked, the system runs an automatic background analysis of your offer without interrupting your setup process.
What happens during validation
After clicking Validate Offer, a progress window appears showing the checks being performed.
You can close this window and continue editing your offer while the validation runs in the background.
The system checks the following items.
Widget block availability Verifies that the required widget block is properly added to your theme.
Auto add gift functionality Checks whether gifts can be automatically added to the cart when conditions are met.
Offer visibility Ensures the offer can be displayed correctly on your storefront.
Pop Up position Confirms that the Pop Up widget can appear in the correct position on your store.
Validation status and results
While validation is in progress, saving the offer is temporarily disabled.
Once the validation is complete The status will be updated automatically The results will appear in the Setup check column in the offer list
If issues are found, you can review the results and adjust your configuration before activating the offer.
When to use Validate Offer
Use this button when You finish setting up a new Free Gift offer You change widget settings or gift logic You want to ensure the offer works correctly before going live
Important notes
Validation does not activate or deactivate the offer. It only checks configuration and storefront compatibility.
You can safely continue working in the app while validation runs.
2. Conditions page
Define what customers must do to qualify for a gift.
2.1 Add Condition
Choose one or more conditions that customers must meet.
Cart value Customers must reach a specific cart total to qualify. Example: Spend 500 dollars to receive a free T-shirt.
Minimum amount The minimum total value of eligible products that must be added to the cart.
Maximum amount The maximum value of eligible products that can be added to the cart. For example: You set the maximum to 1000$, and the customers exceed that 1000$ mark, they will no longer receive the gift. If you don't add anything, you don't have to pay attention to it! 😄
Cart quantity Customers must add a specific number of items to qualify. Example: Buy 1 book, get 1 free bookmark.
Minimum quantity The minimum number of eligible items required in the cart.
Maximum quantity The maximum number of eligible items in the cart.
2.2 Apply Conditions To
Choose which products the conditions apply to.
Specific products Only selected products count toward qualifying for the gift.
Product collections All products in selected collections count toward qualifying.
Specific variants Only selected product variants count toward qualifying.
Product tags Only products with the specific tags count toward qualifying.
All products All products count toward qualifying.
2.3 Active Dates
Set the start date and time for the offer. Optionally set an end date and time.
3. Reward page
Define how gifts are offered and added to the cart.
3.1 Gift Adding Method
Choose how gifts are added once customers qualify.
Automatically add gifts
Add all products from the list All selected gift products are automatically added to the cart when conditions are met. You can set the quantity for each gift individually.
Add the first available gift Only the first available product from the gift list is added. If the first product is out of stock, the next available product is added automatically.
Example: If Hydrogen is out of stock, Oxygen will be added instead. If two gifts are allowed and only one Hydrogen is available, the cart will receive one Hydrogen.
Discount the cheapest product The cheapest product in the customer's cart will be given a discount of your choice.
Number of gifts customers receive Set the total number of gifts customers can receive.
Customers choose gifts manually
Customers select their preferred gifts from the gift list.
Let the customer choose quantity: The customers will be able to choose their own quantity of the gifts.
Fixed product quantity: The quantity will be fixed.
Number of gifts customers receive Customers must select all required gifts before the system can add them to the cart.
3.2 Discount Settings
Define how the gift price is discounted.
Percentage discount Apply a percentage off the gift price. Example: 50 percent off.
Fixed amount off Deduct a fixed amount from the gift price. Example: 10 dollars off.
Free gift Set the gift price to zero.
Amount off each Deduct a fixed amount from every item in the customer's cart.
Please avoid using commas or dots in the discount code, as this may cause the discount to fail.
3.3 Other settings/behaviors
Prevent customers from changing the offer quantity
When enabled, customers cannot manually change the quantity of the gift in their cart.
This helps ensure the gift quantity always follows the rule configuration and prevents customers from increasing or decreasing the gift amount.
Prevent customers from changing the quantity or removing the offer product from their cart
When enabled, customers cannot modify or remove the gift product once it has been added to the cart.
This ensures the offer remains intact as long as the qualifying conditions are met.
Limit the number of times this discount can be used per order
Set a maximum number of times the Free Gift offer can apply within a single order.
By default, the offer repeats per order.
Example Spend 100 dollars, get 1 gift Spend 200 dollars, get 2 gifts
When a limit is set, the gift will stop applying once the maximum number of uses is reached.
Limit the number of times this discount can be used in total
Set a total usage limit across all orders.
Once the maximum number of uses is reached, the Free Gift offer will automatically stop applying for all customers.
Auto remove offer from the cart if the conditions are not met
When enabled, the gift is automatically removed from the cart if the customer no longer meets the qualifying conditions.
If the customer removes a required product or lowers the cart value, the gift will be removed accordingly.
Hide out-of-stock items
When enabled, out-of-stock gift products will not be shown to customers.
This helps prevent customers from selecting unavailable gifts and ensures a smoother checkout experience.
3.4 Discount Combinations
Choose whether the Free Gift offer can work together with other discounts.
You can control compatibility with Product discounts Order discounts Shipping discounts
4. Widget Settings
The Widget section allows you to control how your Free Gift offer is shown to customers on your storefront.
You can enable one or multiple widgets at the same time to increase visibility and improve conversion.
By default, all widgets are enabled for better exposure. When multiple widgets are active, customers can only claim the reward from the Pop Up, while the Embedded Widget displays their reward status only.
4.1 Choose Widget Type
Notification Widget
Displays a small notification banner to inform customers when they unlock a free gift.
This widget acts as a subtle reminder and does not interrupt the shopping experience.
Best used for Reminding customers they have qualified Encouraging them to open the Pop Up to claim the gift
Pop Up Widget
Displays the free gift offer in an overlay window.
This widget captures high attention and allows customers to actively claim their reward.
Available display locations All pages Home page Collection page Product page Cart page Specific page
The Pop Up Widget is the primary widget used for claiming gifts when multiple widgets are enabled.
Embedded Widget
Displays the free gift offer directly inside the product page or cart.
This widget provides a non-disruptive experience and allows customers to view available gifts while browsing products.
Important note When multiple widgets are enabled, the Embedded Widget is used for display and status only. Customers must use the Pop Up Widget to claim the gift.
4.2 Widget Preview
The Preview panel shows how each widget will appear on your storefront.
You can preview Notification banner Pop Up Widget Embedded Widget
4.3 Campaign Summary
The Campaign Summary provides a quick overview of your setup.
Condition Summary
Displays the qualifying conditions required to unlock the gift. Example Cart quantity, cart value, or product conditions.
Reward Summary
Shows how the reward is configured, including Number of gifts Reward selection method Discount type applied to the gift
Last updated
Was this helpful?