Promotion Module

Promotion Module

Configurable promotion engine for all contexts

Easily set up advanced conditional logic for any type of promotion in your Medusa Admin. Create discounts, buy X get Y promotions, unique customer group promotions, and much more.

icon

Overview

Tailored promotions for any situation

Compute discounts based on products, orders, or customer context such as regions or customer groups.

Templates for product and order discounts

Use promotion templates to set up discounts for bundles, product types, order amount, and more.

altText of the image

Targeted customer promotions

Set conditions to determine what regions, currencies, sales channels, or customer groups a promotion should be available to.

altText of the image

Create automatic promotions

Create promotions based on customer context that are applied automatically without a coupon.

altText of the image

Easily add to campaigns

Add promotions to campaigns and set budgets, track spending, control start/end dates, and more.

altText of the image

Advanced Promotions

Set up advanced promotion logic to determine how your different discounts should work.

icon

Customize Everything

Custom promotions that fit your architecture

The Promotion Module works with other modules, standalone, or alongside third-party systems. Use the promotions API to create custom promotions logic.

Add custom promotions logic

Use the promotions API to add your own custom promotions logic and conditions, or extend it with your own custom data models.

altText of the image

Part of a pluggable architecture

Our framework lets you orchestrate your commerce stack as you prefer. Integrate your favorite tools or replace Medusa’s modules with third-party systems without full data migrations or syncs.

altText of the image
icon

Features

Advanced promotion logic for all contexts

Create conditional promotion rules that are easily controllable from the Medusa Admin and can fit in any architecture.

Conditional promotion engine

  • Set advanced conditional promotions rules

  • Manage all promotions in your admin

  • Target promotions toward regions or customers

  • Intuitive UI flows to create conditional promotions

  • Base discounts on cart items or value

  • Support “Buy X get Y” discounts

  • Associate promotions with campaigns

  • Apply promotions automatically based on cart context (no coupon)

Customize for any context

  • Add your own custom rules via the Promotions API

  • Add custom Widgets to the Promotion admin page

  • Create custom promotions from the admin

  • Add custom Widgets to the Promotion admin page

  • Replaceable with your own promotions engine

  • Connects with third-party systems using Workflows

  • Works with all Medusa modules

  • Fully open-source and ships as npm

  • Use standalone with your own systems

Ready to build your custom commerce setup?