Spend $200 Get Promo Item

When to use this

Use this template when you want to give a free promotional item ("free gift with purchase") above a spend threshold – for example "free gift on orders over $200". It's the classic upsell incentive for higher-value baskets and works particularly well alongside seasonal campaigns.

🚧

Storefront support

This action requires your storefront to handle the promotional item that Deducto indicates should be added to the cart. It's currently only available for custom storefront integrations – not Shopify. For Shopify projects, the closest equivalent is an Item Group promotion that prices a specific product at A$0 when the customer has manually added it to their cart and a spend threshold is met.

How it works

This is a Whole Cart promotion gated by a subtotal trigger, with an action that signals the storefront to add a free promotional item.

• Trigger condition on Discounted Subtotal – the cart must be at least A$200 after any earlier promotions have been applied. Using Discounted Subtotal (rather than Original Subtotal) means the threshold is checked against the post-discount cart, so customers can't game it with stacked discounts.
• Add a Promotional Item to the Cart action – the Verify response will instruct the storefront to add the nominated product to the cart (with quantity 1) at no charge. Your storefront is responsible for either inserting the item, or marking it as free if it's already in the cart.
• Max Use Per Email Address Count: 1 – limits the gift to one redemption per customer email. Most "free gift" offers want this cap to prevent gaming.
• Lock Affected Items: Yes – the promotional item itself is locked out of other promotions.

For the underlying concepts see Trigger Conditions and Promotion Action in Creating a Promotion. For the storefront-side implementation see the Custom Storefront Integration guide.

Step-by-step setup

1. From your Deducto Dashboard, open the promotions list for your project and click New.
2. Choose Whole Cart as the promotion type.
3. On the General Information tab, set the name and behaviour. The full set of values is in the field reference below.
4. On the Trigger Conditions tab:
   • Leave the condition orchestration as "If all of these conditions are true".
   • Add one condition: select Discounted Subtotal as the attribute, set the operator to is greater than or equal to, and enter 200 as the AUD value.
5. On the Action tab, choose Add a Promotional Item to the Cart:
   • Click Search Product. Use the Entity Searcher (if you have a search integration set up) to pick the gift product, or choose Manual Entry to enter the gift product's ID directly.
   • Set Quantity to 1.
6. Click Save.

Once saved, make sure your storefront's integration handles the promotional item in the Verify response – see the Custom Storefront guide for the response shape and the recommended cart-update pattern.

Variations

• Different threshold or gift quantity. Adjust the Discounted Subtotal value or the action's Quantity.
• Different gift product. Reopen the action and pick a different product.
• No per-customer cap. Set Max Use Per Email Address Count to 0 if the offer should be unlimited per customer.
• Time-limited offer. Set Start and End to bound the campaign window.

Testing

1. Add items totalling less than A$200 in Discounted Subtotal and confirm the Verify response does not include the promotional item.
2. Add more items so the cart exceeds A$200 and confirm the Verify response indicates the promotional item should be added.
3. Manually add the promotional item to your cart and confirm the storefront marks it as A$0 (or otherwise indicates it's free).
4. Remove items so the cart falls below A$200 and confirm the promotional item is no longer indicated as free.
5. Verify the storefront's handling of the promotional item end-to-end – from cart, through checkout, to the recorded order.

Field reference

The full set of fields used by this template: