How to Automatically Add a Free Gift to a Shopify Cart
What you will achieve in this guide
Follow the feature-specific setup and testing instructions below. Check the supported pages and plan requirements before activating the feature.
Gift with purchase adds the selected gift when the checkout qualifies. This auto-add checkout implementation requires Shopify Plus. Verify the gift’s actual zero charged price as well as its presence.
How this feature works
A trigger product determines who qualifies for an offer; the offer product is the recommendation the buyer can purchase. Configure the campaign in Rivio and place its matching block on the intended Shopify page. Checkout, Thank you, and Order status are separate surfaces with separate testing flows.
Before you begin
Use an eligible Shopify Plus store. Open Apps > Rivio Checkout Customizer and check the feature’s listed supported page. For a visual feature, configure it in Rivio and save its matching editor placement.
Worked example: Add a free gift only above the intended threshold
Example setup: Shopify Plus; an available Demo Keyring gift variant; USD test carts.
Step-by-step instructions
Open Gift with purchase / Auto-add product and create a rule named Keyring over 100.
Select the exact Demo Keyring variant and the supported gift quantity, such as 1.
Set the eligibility condition greater than 100 using the editor’s amount basis and USD for this example.
Review the form’s free-price behavior; selecting a gift product alone is not proof of a zero checkout price.
Save as Active, place the corresponding supported checkout block through the editor link, and save the editor.
Test below and above the threshold, then reduce a qualifying cart and review how the gift responds.
Complete a qualifying test order and inspect the gift quantity and actual charged price.
Verify the result
| Test case | Expected result or verification |
|---|---|
| $100 eligible amount | Does not qualify for a strictly greater-than rule. |
| $101 eligible amount | The intended gift is added; verify one unit and a zero charged price. |
| Cart drops below threshold | Verify it no longer receives an unintended free gift. |
Important: Keep the selected gift in stock and available. Use Gift options for paid wrapping or a gift message; that is a different feature.
If the result is different
| Check | What it means / what to do |
|---|---|
| Gift not added | Check Plus eligibility, Active rule, selected gift variant availability, qualifying inputs, and required saved placement. |
| Gift added but charged | Review the actual free-price settings and final checkout discount/charge. |
| Cart stops qualifying | Reduce/remove qualifying items and verify no unintended free gift remains. |
Related guides
- How to Add Upsells to Shopify Checkout, Thank You & Order Status Pages
- How to Add an Upsell to Shopify Checkout
- How to Add an Upsell to the Shopify Thank You Page
Need help?
Email support@rivioapps.com with your store domain, feature name, target page, the relevant settings, and a screenshot of the actual result. Include the test cart, customer, or order details needed to reproduce the issue.
Use cases and limitations
- A gift must be available and actually charged at zero before it can be advertised as free.
- Test removal of eligibility and repeated recalculation; do not assume unsupported campaign priority.
Screenshot to add: The Auto-add product configuration, supported placement, and actual saved customer result.
Screenshot reference
Screenshot to add: The saved settings described in this guide, with its selected conditions or scope visible.
Screenshot to add: The worked example’s actual customer result or saved Shopify record, including the relevant test inputs.
Was this article helpful?
Your feedback helps us continuously improve our setup guides and documentation.
Thank you for your feedback! Our documentation team reviews all suggestions.