Stock Location Concepts

In this guide, you’ll learn about the main concepts in the Stock Location Module.

Stock Location#

A stock location, represented by the StockLocation data model, represents a location where stock items are kept. For example, a warehouse.

Each stock location can have custom metadata associated with it, allowing you to store additional information as key-value pairs.

Note: The metadata field is available since Medusa v2.14.0.

Medusa uses stock locations to provide inventory details, stored and managed by the Inventory Module, per location.


StockLocationAddress#

The StockLocationAddress data model belongs to the StockLocation data model. It provides detailed location information including:

  • Address lines: Primary and secondary address information
  • Geographic details: Country code, city, province, and postal code
  • Contact information: Company name and phone number
  • Custom metadata: Additional key-value pairs for extra location data
Was this page helpful?
Ask Bloom
For assistance in your development, use Claude Code Plugins or Medusa MCP server in Cursor, VSCode, etc...FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break