DEV Community

Cover image for Medusa v1.3.1: PriceList API, Promotions API, Migrations, And More!
Shahed Nasser for Medusa

Posted on • Originally published at

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.

PriceList API

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.

Promotions API


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.

Services Reference

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.

Events Reference

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
Enter fullscreen mode Exit fullscreen mode

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!

Advanced Next.js Storefront

Discussion (5)

oto profile image

I want to use this to develop an e-commerce website

shahednasser profile image
Shahed Nasser Author

Sounds like a great plan! You can refer to the quickstart guide to get started and the documentation for more details!

keni_pratik profile image
pratik keni

Can we integrate other payment methods besides stripe ?
is Medusa production ready so i can build websites for clients ?

Thread Thread
shahednasser profile image
Shahed Nasser Author

Yes there are also PayPal and Klarna plugins. Additionally, we have a detailed guide on how to create your own payment provider.

Medusa is production ready and is currently being used by companies with large number of sales. Here's an example of a production store using Medusa.

If you're interested in learning more about Medusa you can also join the Discord server and ask all the questions you want to Medusa's core team!

johnyki79579551 profile image

Within this webpage, you'll see the page, you need to understand this data. personal loan benefits