LogoLogo
Build appsContact API support
Discounts and tips
  • Build apps
  • Site Templates
  • API Reference
  • Changelog
Discounts and tips
  • Discounts and tips overview
  • Add discounts to the store
    • Automatic discounts (promotions)
    • Discount coupons
    • Bulk discount prices for products
    • Discounts calculated on your server
  • Add tips or surcharges to the store
    • Add tips selection to the checkout
    • Apply hidden surcharges
    • Calculate surcharges on your server
  • Customize discounts
    • Set up "Buy X - Get Y" promotions
    • Set up "Free shipping" promotions
    • Set up start and end dates for discounts
    • Limit discounts to customer groups
    • Limit discounts by products and categories
    • Limit the number of discount coupon uses

Lightspeed® 2025

On this page
  • Add a new promotion to the store
  • Customize promotions

Was this helpful?

  1. Add discounts to the store

Automatic discounts (promotions)

PreviousDiscounts and tips overviewNextDiscount coupons

Last updated 2 months ago

Was this helpful?

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.

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:

Buy X - Get Y promos

Engage customers

Plan promotions

Set up "Buy X - Get Y" promotions
Limit discounts to customer groups
Set up start and end dates for discounts

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

instructions