Medusa won the Golden Kitty Award for Best Ecommerce Product ✨  Learn More

Medusa Logo
  • Developers
  • Blog
  • Pricing
  • Community
  • About
  • Careers
  • Get Started
  • Developers
  • Blog
  • Pricing
  • Community
  • About
  • Careers
  • Get Started
Company

Medusa v1.7.3: Sales Channels out of Beta, Improvements to events, and more!

Learn about the latest changes and updates in Medusa v1.7.3

Medusa v1.7.3: Sales Channels out of Beta, Improvements to events, and more!

Share

Person photo
Shahed NasserJan. 11, 2023• 3 min.

Time for another exciting release of Medusa!

Version 1.7.3 moves Sales Channels and Publishable API Keys out of beta, introduces improvements for events system and payment sessions, and more.

Keep reading below to learn more about all the new changes in this release of Medusa!

How to Update Medusa?

Medusa Server

You can update your Medusa server using the following command:

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

Then, please follow the upgrade guide for additional required steps.

Medusa Admin

You can also update the Medusa Admin by pulling changes from the GitHub repository.

Sales Channels

We first introduced Sales Channels in v1.3.5 of Medusa. However, as this feature was in beta mode, it was guarded by feature flags. As of v1.7.3, it is enabled by default.

If you’re not familiar with what sales channels are, they allow merchants to create separate channels they sell their products in. Then, they can specify which sales channels are available in that sales channel.

Subsequently, this would lead to showing customers only products available in their sales channels.

For example, in a B2B use case, a merchant can create a B2B sales channel with products only available for B2B customers. Other types of customers wouldn’t be able to purchase these products.

Learn more about Sales Channels in this documentation.

Publishable API Keys

Publishable API Keys are used to associate resources with an API key. Then, when that publishable API key is used on the client-side, retrieving or processing data is only performed on the defined scope of resources for this API key.

This can be useful when you have resources that you have to pass as parameters for every or most requests.

An example of this is using sales channels on the storefront. You would need to pass the ID of the sales channel to the list products and the create cart requests, among others. This approach is error-prone and can be a hassle during development.

With Publishable API keys, you can just pass the API key in the header of the request. When using tools like Medusa JS Client or Medusa React, you only need to pass the API key once, and it’ll automatically be added to all requests.

At the moment, publishable API keys can only be associated with sales channels.

Learn more about Publishable API Keys in this documentation.

Improvements in the Events System

Medusa’s events system allows you to subscribe a handler method to certain events. The handler method would perform asynchronous action when the event is triggered.

For example, you can subscribe to the order.placed event so that when it’s triggered, you send the customer an email.

In v1.7.3, we introduce improvements into the events system, the main being the ability to retry failed handler methods. Errors can commonly occur in handler methods, either due to errors in the logic of the method or due to errors with third-party services.

You can now specify a unique ID of a subscribed event handler and specify how many times it should be retried in case it fails. Improvements also include enhanced readability and allowing for horizontal scaling.

Learn more about the events architecture in this documentation.

New Payment Session Flow

In v1.7.3, we refactored our payment session flow to improve its performance. The new change reduces the amount of times Medusa communicated with the third-party payment providers.

This improvement does not require any changes in how you use and implement the checkout flow or any payment-related flow.

Redesigned Admin Sidebar

The admin sidebar is now redesigned for a clearer design. The team and users section is now removed, and the sidebar is only focused on important links such as Orders and Products.

In upcoming versions, we’ll introduce additional redesign changes such as collapsible sidebar, history, improved help center, and more.

Documentation Changes

In our documentation we’ve implemented general fixes and added new documentation pages such as:

  • Storefront guide on how to implement customer profiles.
  • Gift cards conceptual guide along with how-to guides for storefronts and admins.
  • Claim-order flow documentation.
  • Development guide on how to customize Medusa Admin.

Did you miss out on?

  • Implementing 5 features in Nike’s Ecommerce Store with Medusa
  • How we improved our documentation
  • Top 10 Medusa Blog Posts of 2022
  • Next.js Storefront: Building a Food Ecommerce Restaurant with Medusa and Paystack
  • 10+ Live Chat Widgets for Ecommerce Stores in 2023

Should you have any issues or questions related to Medusa, then feel free to reach out to the Medusa team via Discord.

Share

Medusa Newsletter

Stay up to date

In our Newsletter you get the most important Medusa news directly in your inbox

Up Next

Deploy a Medusa Server on AWS with Microtica

A Step-by-Step Tutorial on How to Deploy a Medusa Server on AWS

Learn how to deploy Medusa on AWS with Microtica

Person photo
Marija NaumovskaJan. 16, 2023• 3 min.

You may also like

Use ChatGPT to Automate Product Description Writing

Use ChatGPT to Automate Product Description Writing

Never think about product descriptions. Automate product description creation with ChatGPT and Medusa

Person photo
Ashutosh KrishnaJan. 19, 2023• 7 min.
Roadmap update - Jan 2023

Roadmap update - Jan 2023

Keep reading to learn about what’s in store for future versions of Medusa.

Oliver Juhl
Oliver JuhlJan. 17, 2023• 4 min.
Inspired by Git: How we Designed our Order-Editing Feature

Inspired by Git: How we Designed our Order-Editing Feature

This article covers how we adopted principles from the Git version control system and GitHub in our Order Editing API design.

Oliver Juhl
Oliver JuhlJan. 25, 2023• 4 min.
Order Edits and Payment Collections are now available

Order Edits and Payment Collections are now available

Learn more about Medusa’s new order-editing feature and how it works

Person photo
Sebastian RindomJan. 25, 2023• 2 min.
Ecommerce APIs: What they are and how they work

Ecommerce APIs: What they are and how they work

This article first discusses the basics of ecommerce APIs and an in-depth evaluation of an open source ecommerce API-first solution —Medusa.

Person photo
Esther ChristopherJan. 23, 2023• 7 min.
Use ChatGPT to Automate Product Description Writing

Use ChatGPT to Automate Product Description Writing

Never think about product descriptions. Automate product description creation with ChatGPT and Medusa

Person photo
Ashutosh KrishnaJan. 19, 2023• 7 min.
Roadmap update - Jan 2023

Roadmap update - Jan 2023

Keep reading to learn about what’s in store for future versions of Medusa.

Oliver Juhl
Oliver JuhlJan. 17, 2023• 4 min.
Inspired by Git: How we Designed our Order-Editing Feature

Inspired by Git: How we Designed our Order-Editing Feature

This article covers how we adopted principles from the Git version control system and GitHub in our Order Editing API design.

Oliver Juhl
Oliver JuhlJan. 25, 2023• 4 min.
Order Edits and Payment Collections are now available

Order Edits and Payment Collections are now available

Learn more about Medusa’s new order-editing feature and how it works

Person photo
Sebastian RindomJan. 25, 2023• 2 min.
Medusa Logo

Product

Medusa for B2BIntegrationsGet StartedCareers
We're hiring

Developers

DocsAPI ReferencesCommunityDiscussions

Medusa

BlogPricingAboutContact Us

Newsletter

Get a summary of what we’ve shipped during the last month, behind the scenes updates, and team picks. Unsubscribe any time.

© 2023 MedusaJS, Inc.