Medusa v2 Documentation

Get Started
Product
Commerce Modules
Architectural Modules
Resources
Guides
Examples
Recipes
UI Library
Admin Components
Storefront Development
Tools & SDKs
Medusa CLI
JS SDK
Next.js Starter
Integrations
Reference
Admin API
Store API
Workflows
Data Model API

Menu

Get Started
Product
Resources
Tools & SDKs
Reference

Documentation

Learn how to build Medusa projects. Explore our guides.

Get startedIntroduction

Create API Route
Build Workflows
Add a Data Model
Build a Custom Module
Link Data Models
Subscribe to Events
Customize Admin
Integrate Systems

1export async function GET(2  req: MedusaRequest,3  res: MedusaResponse4) {5  const query = req.scope.resolve("query")6
7  const { data } = await query.graph({8    entity: "company",9    fields: ["id", "name"],10    filters: { name: "ACME" },11  })12
13  res.json({14    companies: data15  })16}

Expose custom features with REST API routes, then consume them from your client applications.·API Routes

Optimized for Customizations

A digital commerce platform with a built-in framework for customizations.

Unlike other platforms, Medusa allows you to easily customize and extend the behavior of your commerce platform to always fit your business needs.

Customize Medusa Application

Create your first application Build a Module Browse third-party integrations

Admin Development

Build a UI Widget Add a UI Route Browse the UI component library

Storefront Development

Explore our storefront starter Build a custom storefront Browse the UI component library

Recipes

Medusa’s framework supports any business use case.

These recipes show how you to build a use case by customizing and extending existing data models and features, or creating new ones.

View All Recipes

Marketplace

Build a marketplace with multiple vendors

Subscriptions

Implement a subscription-based commerce store.

Restaurant-Delivery

Build a restaurant marketplace inspired by UberEats, with real-time delivery handling

Digital Products

Sell digital products with custom fulfillment.

Browse Commerce Modules

All commerce features are provided as extendable modules in Medusa.

Click on any of the commerce modules below to learn more about their commerce features, and how to extend and use them for your custom use-case.

Cart & Purchase

Checkout, Total calculations, and more

Cart

Add to cart, checkout, and totals.

Payment

Process any payment type.

Customer

Customer and group management.

Merchandising

Products, pricing, and promotions.

Pricing

Configurable pricing engine

Promotion

Discounts and promotions

Product

Variants, categories, and bulk edits

Fulfillment

OMS, fulfilment, and inventory.

Order

Omnichannel order management

Inventory

Multi-warehouse and reservations

Fulfillment

Order fulfillment and shipping

Stock Location

Locations of stock-kept items

Regions & Channels

Multi-region and omnichannel support.

Region

Cross-border commerce

Sales Channel

Omnichannel sales

Tax

Granular tax control

Currency

Multi-currency support

User Access

API keys and authentication.

API Keys

Store and admin access

User Module

Admin user management

Auth

Integrate authentication methods

Was this page helpful?