Skip to main content

Auto Add Free Item Promotion and Promotion Suggestions

Use Case: You want to create a gift with purchase promotion when buying necklace to get a free ring.

To set this up in the Promotions Builder:

  1. In Commerce Manager, go to Merchandise > Promotions > Builder. Edit or create a new promotion.
  2. NOTE: We recommend that you toggle OFF Coupon-driven to make this an automatic promotion.
  3. Under Conditions, configure the cart eligibility condition. See Setting up a Promotion
  4. Under Actions, select Buy X, Get Y discount.
  5. Select percentage discount and set to 100% off.
  6. Select the target product.
  7. Click + refine, and then select Auto-add the product
  8. Click Done and Save the promotion. See Auto Add Free Item.

Result:

  • When the cart meets the condition requirement, the free item(s) will be automatically added to the cart.
  • When the cart loses eligibility, the free item(s) will be removed.

Demo Video

Gift with purchase promotion
Auto add free item with Promotions Builder

Use Case: You want to create upsell product promotion when buying a necklace and get a ring for 50%.

To set this up in the Promotions Builder:

  1. In Commerce Manager, go to Merchandise > Promotions > Builder. Edit or create a new promotion.
  2. NOTE: We recommend that you toggle OFF Coupon-driven to make this an automatic promotion. If you want to have Coupon-driven, see the following case for guidance.
  3. Under Conditions, configure the cart eligibility condition. See Setting up a Promotion
  4. Under Actions, select Buy X, Get Y discount.
  5. Select percentage discount and set to 50% off.
  6. Select the target product.
  7. Click + refine, and then select Add upsell suggestion
  8. Click Done and Save the promotion. See Auto Add Free Item.

Result:

  • When the cart meets the condition requirement, the upsell suggestion for the discounted item will show up in the cart.
  • When the discounted item is added to the cart, the suggestion will disappear.

Demo Video

Buy X Get Y Product Suggestions
Buy X Get Y Product Suggestions

Use Case: Applying coupon code with promotion suggestion.

You want to show promotion suggestion when the shopper applies coupon code to a shopping cart.

  1. Follow the same Commerce Manager steps as above, except the Coupon-driven is ON. In the storefront experience, when the cart meets the condition requirement and the shopper applies the coupon code, the promotion suggestion will show up in the cart. When the shopper adds the suggested item to the cart, storefront can use the Bulk-Add Items endpoint to add the discounted item AND the coupon code in a single request to see the discount in effect. For example:
"data": [
    {
        "type": "cart_item",
        "sku": "ring",
        "quantity": 1
    },
    {
        "type": "promotion_item",
        "code": "50_OFF"
    }
]

For more details, see Bulk Add Items to Cart API.