Automatic discounts (promotions)

Promotions is a built-in Ecwid feature that allows you to set up highly configurable discounts. Once set up, promotions are automatically applied to orders at the checkout upon meeting their conditions.

Conditions for applying promotions include a variety of factors, such as the total order value, the number and categories of items in the order, or the customer's group. Promotions can apply to the order total, shipping costs, or even individual products in the cart.

Add a new promotion to the store

As a developer, you only need to define conditions and settings for the promotion. Ecwid takes care of applying the promo at the checkout on any cart change event.

If you don't yet have an app for Ecwid API access, start with the following instructions.

Make sure your app has the create_promotion access scope required to create promotions.

Example request for creating a new promotion:

POST /api/v3/STOREID/promotions HTTP/1.1
Host: app.ecwid.com
Content-Type: application/json
Authorization: Bearer secret_token

{
    "name": "10% OFF on $500",
    "discountBase": "SUBTOTAL",
    "enabled": true,
    "discountType": "PERCENT",
    "amount": 10,
    "triggers": {
        "subtotal": 500
    }
}

Change STOREID with your store ID and secret_token with the secret access token of your app to add a promotion to your store. The example request adds an automatic 10% discount if the order subtotal reaches $500.

Customize promotions

Promotions offer several customization options, including custom trigger conditions, delayed start, discounts based on shipping method and for shipping costs, "buy X get Y" promos, and more:

Last updated

Was this helpful?