For the complete documentation index, see llms.txt. This page is also available as Markdown.

Create a GWP

Set up a Gift with Purchase that adds the correct gift to the right customer at the right time.

Use this setup when a shopper should receive a free item automatically after qualifying.

Important behavior to understand

This setup auto-adds the gift to cart.

The customer does not choose the gift inside the standard GWP flow.

If you select multiple variants in Free Gifts, all selected variants are gifted when the offer qualifies.

Roadmap does not interpret that list as choose one.

If the customer should choose one gift from several options, use a choice-based setup instead.

Before you start

Decide these four things first:

  • what should trigger the gift

  • who should be allowed to qualify

  • which gift variant or variants should be given

  • whether one order can receive the gift more than once

Create the GWP

1

Open Discounts / Gift with Purchase

Start from the main discounts dashboard.

2

Create a new discount

Choose Gift with Purchase.

3

Add a clear internal name

Use a name your team can recognise later.

4

Choose the condition

Pick the rule that should trigger the gift:

  • Minimum Spend

  • Buy X Get Y

  • Buy A+B+C Get Y

5

Choose who can qualify

Set Customer Eligibility only as wide as needed.

6

Add the gift variant or variants

Select the correct gift in Free Gifts.

If you select more than one variant here, the GWP adds all selected variants after the cart qualifies.

It does not let the customer pick one from that list.

Set Maximum number of uses per order if one order should receive the gift only once.

7

Set Active Dates and save

Choose the start time and optional end date, then save the offer.

8

Test with a fresh cart

Build a cart that clearly qualifies and confirm the gift line item appears.

How to pick the right condition

Use Minimum Spend for threshold campaigns like "spend $100, get a gift".

Use Buy X Get Y for product-specific or quantity-specific offers.

Use Buy A+B+C Get Y when shoppers must add a set combination of products.

How to avoid common setup mistakes

Check these before you go live:

  • the gift variant is the correct one

  • multiple selected gift variants are intentional

  • the offer is set to Active

  • the active dates are current

  • the audience is not broader than intended

  • the gift cap is not left on No limit unless that is intentional

Test before launch

Run these tests:

  1. a cart that does not qualify

  2. a cart that clearly qualifies

  3. a logged-in customer test if eligibility uses tags or member tiers

Next steps

Last updated