import { EllipsisHorizontal, ArrowUpRightOnBox, EllipsisVertical } from "@medusajs/icons"

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

{metadata.title}

In this guide, you’ll learn what regions are and how to manage them.

What is a Region?

A Region represents different countries or areas that your commerce store serves customers in. A region can have multiple countries with the same settings, but a region can also be specific to a single country with its own settings.

Each region has its own settings, such as currencies, payment providers, and fulfillment providers. You can set up regions to manage different aspects of your store based on the location of your customers.

Tax-Inclusive Pricing for Regions

A region has a tax-inclusive pricing setting that determines how taxes are added to prices for the region. During checkout, after Medusa calculates the tax of a product or shipping, it will either:

• Add the tax to the product's price (tax-exclusive pricing).
• Include the tax in the product's price (tax-inclusive pricing).

You can manage this setting during region creation or update.

---

View Regions

To view regions in your store, go to Settings → Regions. Here, you can see a list of all the regions you have set up in your store. You can also search, filter, and sort the regions to find the one you are looking for.

---

Create Region

To create a region:

1. Go to Settings → Regions.
2. Click the Create button in the main section's header.
3. In the form that opens:
   • In the Name field, enter a name for the region. For example, "Europe".
   • In the Currency field, select the region's currency. A region can only have one currency.
   • If you don't want taxes to be calculated automatically during checkout, you can disable the "Automatic Taxes" toggle. This input is mostly useful for developers and should be administered by your technical team.
   • If you want to enable tax-inclusive pricing, toggle the "Tax inclusive pricing" setting.
   • Under the Countries section, you can add the countries that are part of the region. To add countries:
     • Click the "Add countries" button.
     • Check the countries to add to the region.
     • Click the Save button.
   • In the Payment Providers field, choose the payment providers that customers in this region can use to pay for their orders.
4. Once you're done, click the Save button.

---

View Region Details

To view the details of a region:

1. Go to Settings → Regions.
2. Click on the region you want to view.

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

---

Edit Region Details

To edit a region's details:

1. Go to the region'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 region's name, currency, payment providers, and settings for automatic taxes and tax-inclusive pricing.
5. Once you're done, click the Save button.

---

Manage Region's Countries

You can manage a region's countries to add or remove them from the region.

Add Countries to Region

To add countries to a region:

1. Go to the region's details page.
2. Click the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the "Countries" section's header.
3. Choose "Add countries" from the dropdown.
4. In the list that opens, check the countries you want to add to the region.
5. Once you're done, click the Add button.

Remove Countries from Region

To remove countries from a region:

1. Go to the region's details page.
2. Under the "Countries" section, check the countries you want to remove from the region.
3. Press <Kbd>R</Kbd> or click the Remove button at the bottom center of the page.
4. Confirm removing the country by typing "Remove" in the pop-up and clicking the Remove button.

---

Manage Region Metadata

Metadata is custom data that can be associated with the region in key-value pairs. This is usually used by developers for custom integrations or to store additional information about the region.

To edit the region's metadata:

1. Click the <InlineIcon Icon={ArrowUpRightOnBox} alt="arrow" /> icon in the "Metadata" section.
2. In the side window that opens:
   • Manage the key-value pairs in the table.
   • To add a new row of key-value pairs before or after a row:
     • Hover over the row and click the <InlineIcon Icon={EllipsisVertical} alt="three-dots" /> icon at its end.
     • Choose "Insert row above" or "Insert row below" from the dropdown.
   • To delete a row of key-value pairs:
     • Hover over the row and click the <InlineIcon Icon={EllipsisVertical} alt="three-dots" /> icon at its end.
     • Choose "Delete row" from the dropdown.
3. Once you're done, click the Save button.

---

Delete Region

<Note type="warning">

Deleting a region is irreversible.

</Note>

To delete a region from your store:

1. Go to the region'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 region by typing the region's name in the pop-up and clicking the Delete button.