Published in


Medusa v1.3.1: PriceList API, Promotions API, Migrations, And More!

This week a new version of Medusa has been released. If you’re not familiar with Medusa, it’s an open source headless commerce platform that recently passed 10K stars on GitHub in less than a year!

Earlier this month we released version 1.3.0 with many new features, then followed it up by version 1.3.1 this week for some fixes and enhancements.

We also published a new release for the Medusa Admin that add a few new UI elements and functionalities.

This article highlights some of the changes and additions that this update holds. If you’re interested in learning more details about the release check out our longer release post.

PriceList API

The addition of the PriceList API adds another layer of customization and extendibility to Medusa by allowing merchants to have even more control over the pricing of products. They can apply specific prices based on advanced conditions and rules.

This change comes, of course, with a new interface in our Admin that allows creating and editing price lists with many handy configurations.

Promotions API

The use case of Promotions API has expanded from standard promotions to advanced promotions conditions. For example, a merchant might want to apply discounts for their VIP customers.

This API will also open the doors for providing better integration with third-party discount services and tools for even more powerful features.


With these new features, we’ve introduced 2 Migration scripts that are necessary to run after Medusa’s upgrade.

To learn more about this check out the upgrade guide for version 1.3.0.

Clean Up

As part of our update to the Medusa Admin, we’ve cleaned it up to remove all unused dependencies and components.

New API References

We’re excited to announce two new features in our documentation: the Services Reference and the Events Reference.

Services can be used in any of your custom endpoints, services, and subscribers. The service reference gives developers a better understanding of what services are available to use and what are some of their methods.

The event’s reference shows developers what events they can listen to in subscribers, when they are triggered, and what data payload can be expected along with the event.

How to Upgrade?

If you want to upgrade your Medusa server, run the following command to update the necessary dependencies:

npm install @medusajs/medusa@latest medusa-interfaces@latest

Also, read the upgrade guide for version 1.3.0.

Coming Soon: Advanced Next.js Storefront

P.S: We’re currently hosting a contest related to customizing the existing Next.js storefront, and the winner receives a Medusa t-shirt! Read more about it here.

We’re working on a new Next.js starter with a cleaner design and more advanced features. This new starter will allow developers to enable or disable features just by changing the store configurations.

Some of the features that will be added and are available to be switched on or off include search using the MeiliSearch plugin; customer accounts with the ability to make changes to their profiles and accounts such as change addresses and see order history; customer self-service returns and exchange; multi-regional support, and more!



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store