Create a gift with purchase promotion

Gift with purchase promotions let you give a customer a free item as part of their order.

You can create two types of gift with purchase promotions:

  • Gift with Item Purchase gives the shopper a free gift with a purchase. You can offer a gift with any purchase or with the purchase of a specific item. This promotion can apply only once per shopping cart. Gift items cannot act as qualifiers for the promotion. For example, suppose you create a promotion that offers a free votive candle with any purchase. If the shopper adds one votive candle to the cart, that candle is not repriced to free. If the shopper then adds another item to the cart, that item qualifies the cart for the promotion, and the votive candle is repriced to free.
  • Spend Y Get Gift with Purchase gives the shopper a free gift when they spend a specified amount. For example, “Spend $100, get a free $10 gift card.” Gift items cannot act as qualifiers for the promotion, so if a shopper adds a gift item to the cart, its price does not count toward the Spend Y total. This promotion can apply only once per shopping cart; if a shopper adds two of the qualifying item, only one will be repriced to free.

When a shopper’s cart qualifies for a gift with purchase promotion, one of the following things happens:

  • If no item in the cart meets the offer criteria, the gift item is automatically added to the cart. The gift item cannot act as a qualifier for other promotions.
  • If the shopper has already added the gift item to their cart, the item is repriced to be free. Once the gift item is repriced, it can no longer act as a qualifier for other promotions.

If the shopper removes the gift from a qualifying cart, Commerce does not automatically re-add the gift while the cart still qualifies for the promotion. There are two ways to add the gift again:

  • If the shopper re-adds the gift item to the cart, the item is repriced to free if the cart still qualifies for the promotion.
  • If the cart becomes unqualified (for example, if the shopper removes items required for the buy condition) and then qualified again (for example, if the shopper adds back items required for the buy condition), Commerce automatically re-adds the gift.

When an item appears in an order object (for example, in the body of an Order Submit webhook), the property gwp specifies whether the item was given as part of a gift with purchase promotion. For gift items, the value of the gwp property is true; for all other items, the value is false. For example:

"gwp":true,

To create a new gift with purchase promotion, follow these steps:

  1. On the Promotions page, click New Promotion and select Gift with Item Purchase or Spend Y Get Gift with Purchase.
  2. Enter the name, description, and price groups for the promotion. See Enter general promotion information for details about each field.
  3. Enter condition and offer details for the promotion. See Enter condition and offer information for details about each field.
  4. On the promotion’s Availability tab, define the promotion’s lifecycle and enter information that determines when the promotion is active and usable. See Enter promotion availability information for details about each field.
  5. (Optional) Specify promotions that cannot be combined with this one. See Exclude promotions for more information.
  6. Click Save.
  7. (Optional) Create a coupon code that customers must provide to redeem the promotion. See Add a coupon code to a promotion for more information.