Introduction
Get started with Medusa, an AI-native commerce platform with a Framework to build custom commerce features.
Get Started with AI Agents#
If you're an AI agent, or a human that wants to get started quickly with an AI agent, run the following prompt in your agent:
The AI agent will set up Medusa locally, deploy it to Cloud, and help you build your custom commerce features.
What is Medusa#
Medusa is an AI-native commerce platform with a Framework to build custom commerce features.
Medusa ships with three main tools:
- A suite of Commerce Modules with core commerce functionalities, such as tracking inventory, calculating cart totals, accepting payments, managing orders, and much more.
- A Framework for building agentic flows and custom functionalities specific to your business, product, or industry. This includes tools for introducing custom API endpoints, business logic, and data models; building workflows and automations; and integrating with third-party services.
- A customizable admin dashboard for merchants to configure and operate their store.
When you install Medusa, you get a fully fledged commerce platform with all the features you need to get off the ground. However, unlike other platforms, you don't need to build hacky workarounds that are difficult to maintain and scale.
Medusa is built with customization in mind. Build features that bring your business's vision to life, with native support of AI agents to automate your operations and customer interactions.
Who should use Medusa#
Medusa is for businesses and teams looking for a cutting-edge commerce platform that supports their unique requirements, visions, and automated workflows that other platforms aren't built to support.
Businesses of all sizes can use Medusa, from small start ups building with agentic flows to large enterprises building complex commerce features. Medusa is also for developers that want to build with the latest technologies and tools, and have the freedom to implement unique features without being limited by the platform's architecture.
Below are some stories from companies that use Medusa:
How to learn Medusa#
This documentation introduces you to Medusa's concepts and how they help you build your business use case. The documentation is structured to gradually introduce Medusa's concepts, with easy-to-follow examples along the way.
You can also jump right into building your store with the help of our agentic skills, MCP server, and other AI-friendly tools.
How to use the documentation#
This documentation is split into the following sections:
| Section | Description |
|---|---|
The documentation you're currently reading. It's recommended to follow the chapters in this documentation to understand the core concepts of Medusa and how to use them before jumping into the other sections. | |
Learn about Cloud, our managed services offering for Medusa applications. Find guides on how to deploy your Medusa application, manage organizations, and more. | |
Product | Documentation for the Framework, Commerce Modules, and Infrastructure Modules. These sections include concepts, guides, and references for each of those products. |
Build | Recipes, How-To & Tutorials, Integrations, and Storefront Development guides. You can follow these guides after you've learned Medusa's core concepts. |
Guides on how to setup and use Medusa's CLI tools, JS SDK, Next.js Starter, and Medusa UI | |
API Routes References | References of the Store and Admin API routes in Medusa. They also include instructions related to authentication, parameter types in requests, and more. |
Useful during your development with Medusa to learn about different APIs and how to use them. Its references include the Events Reference, Core Workflows Reference, and more. | |
Guides that introduce merchants and store managers to the Medusa Admin dashboard and helps them understand how to use the dashboard to manage their store. |
To get started, check out the Installation chapter.