Skip to main content
More in Learn

Promotion

A promotion is a price adjustment, permanent or temporary, applied at the cart level. If a customer puts enough of the right items in their cart or enters the right code, this can trigger deals and discounts in response. On an eCommerce website, one would only see these particular adjustments on the cart and/or at checkout.

Promotions allow you to implement useful features like:

  • Coupons or promo codes for discounts
  • Free shipping when certain conditions are met
  • Buy-X-Get-Y sales

Every promotion is defined by attributes such as:

  • Mechanism. The type of promotion may be percentage (increments/decrements the original price by a specified percentage), relative (increments/decrements the price by a given amount), fixed (sets the price to a specified value), or X for Y (When X items are in the cart, charge what is normally paid for Y items. If items in the cart have different prices, then the cheapest one(s) will be discounted).
  • Period (optional). The time period(s) during which the promotion is valid. If left unspecified, the promotion takes effect immediately and is permanent until it is modified or deleted.
  • Trigger (optional). The condition(s) that enable the promotion to be applied (e.g. if 3 of a certain product variant is placed in the cart). If no trigger is specified, the promotion will be applied to every cart.
  • Target (optional). The product variant(s) that will receive the price adjustment. If no target is specified, the promotion will be applied to every product in the catalogue. In some cases, the target item(s) may be identical to the trigger item(s).

You can create and manage promotions within the Crystallize App. You can also set up promotions programmatically using the Shop API.

People showing thumbs up

Need further assistance?

Ask the Crystallize team or other enthusiasts in our slack community.

Join our slack community