ContextQMD
Back to Medusa

{metadata.title}

www/apps/user-guide/app/settings/locations-and-shipping/locations/page.mdx

2.14.216.3 KB
Original Source

import { EllipsisHorizontal, TaxExclusive, TaxInclusive, ArrowsPointingOut, Plus } from "@medusajs/icons"

export const metadata = { title: Manage Locations in Medusa Admin, }

{metadata.title}

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 in the main section's header.
  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 the location you want to view.

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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the first section's header.
  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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the header 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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the header 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" next to 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 Shipping Option Type field, choose the shipping option type that this option belongs to. Shipping option types are useful to group similar shipping options together, allowing you to apply promotions at a group level.
    • In the Fulfillment Provider field, choose the fulfillment provider that will handle shipping orders using this option.
    • 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 based on the integrated fulfillment service.
    • 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.

Fixed and Conditional Shipping Option Prices

In the Prices step, use the Bulk Editor to enter the shipping option's prices for every currency and region in your store.

<Note title="Tips">
  • Price columns that have the <InlineIcon Icon={TaxExclusive} alt="tax-exclusive" /> icon are tax-exclusive prices. Medusa will calculate taxes during checkout and add them to this price.
  • Price columns that have the <InlineIcon Icon={TaxInclusive} alt="tax-inclusive" /> icon are tax-inclusive prices. Medusa will calculate taxes during checkout as part of this price.

Tax-inclusive pricing is configured in the currency's or region's settings.

</Note>

Shipping option prices can also be conditioned based on the cart's total. For example, you can make the shipping option free if the cart's total exceeds $100. So, you can set a fixed price for a shipping option, and then set a conditioned price based on the cart's total.

To set a conditioned price for the shipping option:

  1. Hover over a cell in the Bulk Editor based on the currency or region you want to set the conditioned price for.
  2. Click the <InlineIcon Icon={ArrowsPointingOut} alt="arrows-pointing-out" /> icon that appears to open the conditional pricing form.
  3. In the form that opens:
    • Conditional pricing card will appear, and you can add another one by clicking the "Add price" button.
    • Enter in the "Shipping option price" field the price when this condition is satisfied.
    • To set the minimum cart total required for this price to apply:
      • Click the <InlineIcon Icon={Plus} alt="plus" /> next to "Minimum cart total".
      • In the field that shows, enter the minimum cart total required for this price to apply.
    • To set the maximum cart total required for this price to apply:
      • Click the <InlineIcon Icon={Plus} alt="plus" /> next to "Maximum cart total".
      • In the field that shows, enter the maximum cart total required for this price to apply.
    • Once you're done, click the Save button.

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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon next to it.
  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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon next to it.
  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

<Note type="warning">

Deleting a service zone is irreversible. It will delete all shipping options in the service zone.

</Note>

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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon next to it.
  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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon next to it.
  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, shipping option type, and whether it's enabled in store for customers to use.
  5. Once you're done, click the Save button.
<Note>

You can't edit a shipping option's fulfillment provider or fulfillment option after its creation.

</Note>

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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon next to it.
  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.
<Note title="Tips">
  • Price columns that have the <InlineIcon Icon={TaxExclusive} alt="tax-exclusive" /> icon are tax-exclusive prices. Medusa will calculate taxes during checkout and add them to this price.
  • Price columns that have the <InlineIcon Icon={TaxInclusive} alt="tax-inclusive" /> icon are tax-inclusive prices. Medusa will calculate taxes during checkout as part of this price.

Tax-inclusive pricing is configured in the currency's or region's settings.

</Note>

Delete Shipping Option

<Note type="warning">

Deleting a shipping option is irreversible.

</Note>

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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon next to it.
  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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the header 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 <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the header 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

<Note type="warning">

Deleting a location is irreversible and will delete its service zones and shipping options.

</Note>

To delete a location:

  1. Open the location's details page.
  2. Click the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the first section's header.
  3. Choose Delete from the dropdown.
  4. Confirm deleting the location by entering its name and clicking the Delete button.