Stock Locations
A stock location represents a physical place where you hold inventory â a warehouse, home workshop, shop floor, or third-party fulfilment centre. You can have as many locations as you need.
Medusa tracks inventory at the location level: you know exactly how many units of each product are at each location, not just a global total.
Creating a stock location
Go to Settings â Locations, click + Add location.
| Field | Description |
|---|---|
| Name | Human-readable label â e.g. "Nairobi Warehouse", "Mombasa Store", "Westlands Pickup" |
| Address | Optional. Used for fulfilment provider integrations and display purposes. |
| Fulfilment providers | Connect one or more fulfilment providers (e.g. your own shipping, Uber Connect) to this location. |
If you only ship from one place, you still need at least one stock location. Create it during store setup â Medusa uses it as the default source for inventory deductions.
Viewing inventory per location
Go to Inventory in the sidebar. Each inventory item shows a row per location with:
- Stocked quantity â total units physically present
- Reserved quantity â units held for open unfulfilled orders
- Available quantity â stocked minus reserved (what can actually be sold)
To edit the quantity at a specific location, click the item, then click Edit next to the location row.
Connecting locations to shipping
Each shipping option in Medusa is linked to a fulfilment set, which is linked to a location. This determines which shipping methods are offered at checkout based on where stock is held.
If you have multiple locations, you can route different products through different locations depending on which carries the stock. This is configured in Settings â Locations â [Location] â Fulfilment sets.
Low-stock management
Medusa does not send automatic low-stock alerts by default, but you can:
- Set a Reorder point on each inventory item (shown as a threshold in the Inventory list)
- Export the inventory list to a spreadsheet for periodic review
- Integrate with a notification provider to trigger alerts when available quantity drops below your threshold
Reservations are created automatically when an order is placed and released automatically when an order is cancelled or a return is received. You never need to manage reservations manually.
Transferring inventory between locations
Medusa does not have a built-in stock transfer workflow. To move stock from one location to another:
- Reduce the quantity at the source location (manual adjustment)
- Increase the quantity at the destination location (manual adjustment)
- Add a note in the inventory item's activity log to record the transfer