Free gifts & samples
Spend tiers unlock a free gift, deluxe mini, or discovery sample as the basket grows. Logged-out shoppers use one set of tiers; logged-in customers with specific tags can be given a separate set. Shoppers choose in the cart.
Two parts
The theme embed is the live picker. Checkout 100% off requires the Vendr free gifts automatic discount with matching products and thresholds.
Theme embed
Enable Free gifts in cart. Set up to four retail tiers and four wholesale tiers (dollar threshold, pick count 1–4, product list).
- Higher tiers add picks; they do not replace lower-tier gifts.
- Qualifying spend is the cart subtotal excluding gift lines.
- Gift lines are quantity 1. Products already in the cart as paid items stay visible but marked Already in cart.
- Logged-out shoppers use the retail tiers. Logged-in customers with wholesale tags use the wholesale tiers (or retail if those are empty).
- Hide for customer tags (for example distributor) hides the picker and applies no gift discount.
Checkout discount
After deploy, create or keep an automatic product discount named Vendr free gifts that uses the vendr-free-gifts-discount function. Its configuration must list the same hide tags, wholesale tags, thresholds, pick counts, and product IDs as the embed.
If the discount is missing or out of date, shoppers can pick gifts in the cart but those lines will not be free at checkout.