Manage Locations in Medusa Admin

In this guide, you’ll learn how to manage the stock locations using the Medusa Admin.

What is a Stock Location?#

A location represents a physical stocking location, such as a warehouse. You can then manage inventory item quantities in those locations.

For each location, you can specify the sales channels it's associated with, the fulfillment providers available in that location, and the shipping options available from that location.

Then, during checkout, a customer can only choose shipping options available from the location associated with the sales channel they're ordering from. After they place the order, the items are fulfilled from the stock location associated with the order's sales channel.

Create Location#

To create a stock location:

1. Go to Settings → Locations & Shipping.
2. Click the Create button at the top right.
3. In the form that opens:
   • Enter the location's name, such as "Main Warehouse".
   • Enter the address details. It's only required to enter an address line and choose a country.
4. Once you're done, click the Save button.

View Location Details#

To view the details of a location:

1. Go to Settings → Locations.
2. Click on "View details" at the top right of the location's section.

This opens the location's details page where you can also manage the location.

Edit Location#

To edit a stock location:

1. Open the location's details page.
2. Click the icon at the top right of the first section.
3. Choose Edit from the dropdown.
4. In the side window that opens, you can edit the location's name and address details.
5. Once you're done, click the Save button.

Create Shipping Options#

A location can have shipping options for the pickup and shipping modes. You can manage these options from the location's details page.

Shipping options are organized by service zones in each shipping mode. A service zone is a geographical area where you can specify the shipping options available. For example, you can create a service zone for the United States, and specify the shipping options available in the US.

So, to create a shipping option for either pick-up or shipping, you need to enable the pick-up or shipping mode, create a service zone for that mode, and create the shipping option within that zone.

1. Enable Shipping Mode#

By default, pick-up and shipping are disabled in a location. To enable either:

1. Go to the location's details page.
2. Click the icon at the top right of the "Pickup" or "Shipping" section.
3. Choose Enable from the dropdown.

You can also disable the shipping mode by following the same steps.

2. Create Service Zone#

To ceate a service zone for pick-up or shipping:

1. Go to the location's details page.
2. Click the icon at the top right of the "Pickup" or "Shipping" section.
3. Choose "Create service zone" from the dropdown.
4. In the form that opens:
   • In the Name field, enter the name of the service zone. For example, "United States".
   • Under the Areas section, you'll choose the countries that are covered by this service zone:
     • Click the "Manage areas" button.
     • Check the countries to add to the service zone.
     • Click the Save button.
5. Once you're done, click the Save button.

Learn how you can further manage this service zone in the Manage Service Zones section.

3. Create Shipping Options#

You can now add shipping options to the service zone you created. You can either add a standard shipping option that's used during checkout, or a return shipping option, which is only used to return items from the customer.

To create a shipping option:

1. Go to the location's details page.
2. In the "Pickup" or "Shipping" section, find the service zone you want to add the shipping option to.
3. Click the "Create option" at the right of either "Shipping options", "Pickup options", or "Return options", based on the type of shipping option you're creating.
4. In the form that opens:
   • If the shipping option isn't a pick-up option, you can choose the price type. Choose Fixed if you want to apply fixed pricing for the shipping option, or Calculated if the price should be calculated dynamically during checkout. Calculated prices are useful if you're using a third-party fulfillment provider that calculates prices dynamically.
     • If you chose Fixed, you'll set the price in the next step of the form.
     • If you choose Calculated and the fulfillment provider you choose doesn't support calculated prices, the shipping option creation will fail.
   • In the Name field, enter a name for the shipping option. Customers will see this option during checkout.
   • In the Shipping Profile field, choose the shipping profile that this option can be used for. Only products belonging to this shipping profile can be shipped with this shipping option.
   • In the Fulfillment Provider field, choose the fulfillment provider that will handle shipping orders using this option.
     • If you don't find the fulfillment provider you're looking for, make sure it's added to the location.
   • In the Fulfillment Option field, choose a fulfillment option from the fulfillment provider. For example, UPS may provide express or standard fulfillment options.
     • If you're unsure about which fulfillment option to choose, contact your technical team for assistance.
   • If you don't want this shipping option to be used by customers during checkout, disable the "Enable in store" toggle. This is useful if you're creating a shipping option that's only used internally.

If you chose a "Calculated" price type, you can click the "Save" button to create the shipping option. Otherwise click Continue to proceed to the Prices step.

In the Prices step, use the Bulk Editor to enter the shipping option's prices for every currency and region in your store. Once you're done, click the Save button.

Learn how you can further manage the shipping option in the Manage Shipping Options section.

Manage Service Zones#

You can manage service zones in pick-up or shipping mode by creating, editing, or deleting them.

Edit Service Zone Details#

To edit a service zone in a location:

1. Go to the location's details page.
2. In the "Pickup" or "Shipping" sections, find the service zone and click on the icon at its right.
3. Choose Edit from the dropdown.
4. In the side window that opens, you can edit the service zone's name.
5. Once you're done, click the Save button.

Manage Service Zone Areas#

To manage the areas in a service zone:

1. Go to the location's details page.
2. In the "Pickup" or "Shipping" sections, find the service zone and click on the icon at its right.
3. Choose "Manage areas" from the dropdown.
4. In the form that opens, manage the areas in the service zone:
   • Click the "Manage areas" button.
   • Check the countries to add to the service zone, and uncheck the countries to remove from the service zone.
   • Click the Save button.
5. Once you're done, click the Save button.

Delete Service Zone#

To delete a service zone:

1. Go to the location's details page.
2. In the "Pickup" or "Shipping" sections, find the service zone and click on the icon at its right.
3. Choose Delete from the dropdown.
4. Confirm deleting the service zone by clicking the Delete button in the pop-up.

Manage Shipping Options#

You can manage shipping options in pick-up and shipping modes by creating, editing, or deleting them.

Edit Shipping Option Details#

To edit a shipping option's details:

1. Go to the location's details page.
2. In the "Pickup" or "Shipping" sections, find the shipping option and click on the icon at its right.
3. Choose "Edit option" from the dropdown.
4. In the side window that opens, you can edit the shipping option's price type, name, shipping profile, and whether it's enabled in store for customers to use.
5. Once you're done, click the Save button.

Edit Shipping Option Prices#

To edit the prices of shipping options whose price type is Fixed:

1. Go to the location's details page.
2. In the "Pickup" or "Shipping" sections, find the shipping option and click on the icon at its right.
3. Choose "Edit prices" from the dropdown.
4. In the Bulk Editor that opens, you can edit the shipping option's price for every currency and region in your store.
5. Once you're done, click the Save button.

Delete Shipping Option#

To delete a shipping option:

1. Go to the location's details page.
2. In the "Pickup" or "Shipping" sections, find the shipping option and click on the icon at its right.
3. Choose Delete from the dropdown.
4. Confirm deleting the shipping option by entering its name in the pop-up and clicking the "Delete" button.

Change Associated Sales Channels#

To change the sales channels associated with a location:

1. Go to the location's details page.
2. Click the icon at the top right of the "Sales Channels" section.
3. Choose Edit from the dropdown.
4. In the list that opens, you can select the sales channels to associate with the location, or unselect the ones you want to remove.
5. Once you're done, click the Save button.

Manage Fulfillment Providers#

To manage the fulfillment providers available in a location:

1. Go to the location's details page.
2. Click the icon at the top right of the "Fulfillment Providers" section.
3. Choose Edit from the dropdown.
4. In the list that opens, you can select the fulfillment providers to associate with the location, or unselect the ones you want to remove.
5. Once you're done, click the Save button.

Delete Location#

To delete a location:

1. Open the location's details page.
2. Click the icon at the top right of the first section.
3. Choose Delete from the dropdown.
4. Confirm deleting the location by entering its name and clicking the Delete button.