***

title: "Promotions"
metaTitle: "Setting Up Promotions and Coupon Codes in Vendure"
metaDescription: "Configure promotions with conditions and actions to offer discounts, free shipping, and coupon codes. Set per-customer usage limits and custom business rules."
order: 4
--------

Promotions are a means of offering discounts on an order based on various criteria. A Promotion consists of *conditions* and *actions*.

* **conditions** are the rules which determine whether the Promotion should be applied to the order.
* **actions** specify exactly how this Promotion should modify the order.

## Promotion Conditions

A condition defines the criteria that must be met for the Promotion to be activated. Vendure comes with some simple conditions provided which enable things like:

* If the order total is at least $X
* Buy at least X of a certain product
* Buy at least X of any product with the specified [FacetValues](/current/core/user-guide/catalog/facets)
* If the customer is a member of the specified [Customer Group](/current/core/user-guide/customers#customer-groups)

Vendure allows completely custom conditions to be defined by your developers, implementing the specific logic needed by your business.

## Coupon codes

A coupon code can be any text which will activate a Promotion. A coupon code can be used in conjunction with conditions if desired.

:::note
Note: Promotions **must** have either a **coupon code** *or* **at least 1 condition** defined.
:::

## Promotion Actions

If all the defined conditions pass (or if the specified coupon code is used), then the actions are performed on the order. Vendure comes with some commonly-used actions which allow promotions like:

* Discount the whole order by a fixed amount
* Discount the whole order by a percentage
* Discount selected products by a percentage
* Free shipping

## Coupon code per-customer limit

If a per-customer limit is specified, then the specified coupon code may only be used that many times by a single Customer. For guest checkouts, the "same customer" status is determined by the email address used when checking out.