Skip to main content


Welcome to Medusa, the open source Shopify alternative!

Medusa is an open-source headless commerce engine that enables developers to create amazing digital commerce experiences.


Get started with Medusa in a few minutes with the Quickstart guide!


Medusa comes with a set of building blocks that allow you to create unique digital commerce experiences, below is a list of some of the features that Medusa comes with out of the box:

  • Headless: Medusa is a highly customizable commerce API which means that you may use any presentation layer such as a website, app, chatbots, etc.
  • Regions allow you to specify currencies, payment providers, shipping providers, tax rates, and more for one or more countries for truly international sales.
  • Orders come with all the functionality necessary to perform powerful customer service operations with ease.
  • Carts allow customers to collect products for purchase, add shipping details, and complete payments.
  • Products come with relevant fields for customs, stock keeping, and sales. Medusa supports multiple options and unlimited variants.
  • Swaps allow customers to exchange products after purchase (for example, for incorrect sizes). Accounting, payment, and fulfillment plugins handle all the tedious work for you for automated customer service.
  • Claims can be created if customers experience problems with one of their products. Plugins make sure to automate sending out replacements, handling refunds, and collecting valuable data for analysis.
  • Returns allow customers to send back products and can be configured to function in 100% automated flow-through accounting and payment plugins.
  • Fulfillment API makes it easy to integrate with any fulfillment provider by creating fulfillment plugins.
  • Payments API makes it easy to integrate with any payment provider by creating payment plugins, Medusa already supports Stripe, Paypal, and Klarna.
  • Notification API allows integrations with email providers, chatbots, Slack channels, etc.
  • Customer Login gives customers a way of managing their data, viewing their orders, and saving payment details.
  • Shipping Options & Profiles enable powerful rules for free shipping limits, multiple fulfillment methods, and more.
  • Medusa's Plugin Architecture makes it intuitive and easy to manage your integrations, switch providers and grow with ease.
  • Customization is supported for those special use cases that all the other e-commerce platforms can't accommodate.

Where to Get Started

The Medusa Server

You can follow the quickstart guide to install and run a Medusa server.

It's also recommended to learn how to set up your development environment with the required tools and services to run a Medusa server, then configure your Medusa server.

The Medusa Admin

The Medusa Admin provides you with a lot of functionalities and configurations such as Product Management, Order Management, Discounts and Promotions, and more.

You can install the Medusa admin in two steps by following the Medusa Admin quickstart guide.

The Storefront

The final step is to set up a storefront to sell your products.

Medusa provides two starter storefronts, one built with Next.js and one with Gatsby, that you can use to quickly set up your store and start selling.

Alternatively, you can build your own storefront with any frontend framework of your choice just by connecting to your server with the Storefront REST APIs.

What’s Next 🚀

Open Source Contribution

As Medusa is an open source platform, contributions to improve it and its documentation are welcome. In the GitHub repository here’s where you’ll find the different components you can contribute to:

You can find more details about contributing in

Community & Support

If you need any support during your development with Medusa, you can join Medusa's Discord Server. You will get help directly from Medusa's core team as well as the community.

By joining the Discord Server, you’ll also have the chance to participate in many events such as Bug Hunts and showcase your work with Medusa.