medusa-store/www/apps/docs/content/modules/multiwarehouse/overview.mdx

---
description: "Multi-warehouse allows merchants to store a product in multiple locations with accurate and consistent inventory data within the commerce application."
---

import DocCardList from '@theme/DocCardList';
import DocCard from '@theme/DocCard';
import Icons from '@theme/Icon';

# Multi-Warehouse

Multi-warehouse allows merchants to store a product in multiple locations with accurate and consistent inventory data within the commerce application.

Multi-warehouse in Medusa is composed of two modules: an inventory module - which is the NPM package `@medusajs/inventory` - and a stock location module - which is the NPM package `@medusajs/stock-location`.

<DocCard item={{
  type: 'link',
  href: '/modules/multiwarehouse/install-modules',
  label: 'Install Modules',
  customProps: {
    icon: Icons['academic-cap-solid'],
    description: 'Learn how to install the modules related to multi-warehouse',
  }
}} />

You can also create your own modules and use them with the Medusa backend.

<DocCardList colSize={6} items={[
  {
    type: 'link',
    href: '/modules/multiwarehouse/backend/create-inventory-service',
    label: 'Backend: Create Inventory Service',
    customProps: {
      icon: Icons['academic-cap-solid'],
      description: 'Learn how to create an inventory service to be used in a custom inventory module.'
    }
  },
  {
    type: 'link',
    href: '/modules/multiwarehouse/backend/create-stock-location-service',
    label: 'Backend: Create Stock Location Service',
    customProps: {
      icon: Icons['academic-cap-solid'],
      description: 'Learn how to create a stock location service to be used in a custom stock location module.'
    }
  },
]} />

---

## Features

### Multiple Stock Locations

Admins can manage the stock locations, which are the places they store their products. Stock locations are associated with different sales channels.

<DocCardList colSize={6} items={[
  {
    type: 'link',
    href: '/user-guide/multiwarehouse/locations',
    label: 'User Guide: Manage Stock Locations',
    customProps: {
      icon: Icons['users-solid'],
      description: 'Learn how to manage stock locations in Medusa Admin.'
    }
  },
  {
    type: 'link',
    href: '/modules/multiwarehouse/admin/manage-stock-locations',
    label: 'Admin: Manage Stock Locations',
    customProps: {
      icon: Icons['academic-cap-solid'],
      description: 'Learn how to manage stock locations using admin APIs.',
    }
  },
]} />

### Inventory Management Across Locations

Admins can manage the inventory of product variants across the different stock locations.

<DocCardList colSize={6} items={[
  {
    type: 'link',
    href: '/user-guide/multiwarehouse/inventory',
    label: 'User Guide: Manage Inventory',
    customProps: {
      icon: Icons['users-solid'],
      description: 'Learn how to manage inventory using the Medusa Admin.'
    }
  },
  {
    type: 'link',
    href: '/modules/multiwarehouse/admin/manage-inventory-items',
    label: 'Admin: Manage Inventory',
    customProps: {
      icon: Icons['academic-cap-solid'],
      description: 'Learn how to manage inventory using the admin APIs.',
    }
  },
]} />

### Manage Item Allocations in Orders

Admins can manage item allocations to choose which stock location to fulfill items from or return items to. Item quantities are reserved in a stock location until the item is fulfilled to ensure data consistency.

<DocCardList colSize={6} items={[
  {
    type: 'link',
    href: '/user-guide/orders/manage#manage-item-allocation',
    label: 'User Guide: Manage Allocations in Orders',
    customProps: {
      icon: Icons['users-solid'],
      description: 'Learn how to manage allocations of items in an order using the Medusa Admin.'
    }
  },
  {
    type: 'link',
    href: '/modules/multiwarehouse/admin/manage-item-allocations-in-orders',
    label: 'Admin: Manage Allocations in Orders',
    customProps: {
      icon: Icons['academic-cap-solid'],
      description: 'Learn how to manage allocations of items in an order using the admin APIs.',
    }
  },
]} />

---

## Understanding the Architecture

The commerce modules automatically detect whether a product variant is in stock, decrement the variant’s stock on fulfillment, and increment the variant’s stock on returns.

<DocCardList colSize={6} items={[
  {
    type: 'link',
    href: '/modules/multiwarehouse/inventory-module',
    label: 'Architecture: Inventory Module',
    customProps: {
      icon: Icons['circle-stack-solid'],
      description: 'Learn about the Inventory Module and how it works.'
    }
  },
  {
    type: 'link',
    href: '/modules/multiwarehouse/stock-location-module',
    label: 'Architecture: Stock Location Module',
    customProps: {
      icon: Icons['circle-stack-solid'],
      description: 'Learn about the Stock Location Module and how it works.'
    }
  },
]} />

---

## Related Modules

Discover Multi-warehouse’s relation to other modules in Medusa.

<DocCardList colSize={4} items={[
  {
    type: 'link',
    href: '/modules/products/overview',
    label: 'Products',
    customProps: {
      icon: Icons['tag-solid'],
      description: 'Manage the inventory of product variants across locations.',
    }
  },
  {
    type: 'link',
    href: '/modules/sales-channels/overview',
    label: 'Sales Channels',
    customProps: {
      icon: Icons['channels-solid'],
      description: 'Stock locations are associated with sales channels.',
    }
  },
  {
    type: 'link',
    href: '/modules/orders/overview',
    label: 'Orders',
    customProps: {
      icon: Icons['check-circle-solid'],
      description: 'Change available stock based on returns and fulfillment.',
    }
  },
]} />