Multi-Region Ecommerce with Medusa: Zones, Currencies, and Taxes from Day One

In Medusa, a region groups everything that varies by country or geographic zone: the currency, taxes, available payment providers, and fulfillment providers. A cart always belongs to a region, and that region determines which price is shown, which tax applies, and which shipping options appear at checkout.

Designing regions from the start of the project avoids the most painful refactor in ecommerce: adding multi-country support to a system that assumed a single currency and a single tax scheme. It is not just adding a country field — it means redefining how prices, totals, and inventory are calculated.

Shipping zones in Medusa define which countries can receive orders from a given region. A zone can have multiple countries and multiple shipping options — standard, express, pickup point. Each option has its own pricing logic: flat rate, weight-based, or managed by an external fulfillment provider.

The recommended pattern is to create one region per group of countries with the same tax scheme and currency. Mexico and Colombia can be separate regions even if both use Stripe, because their taxes and currencies differ. Grouping countries by cultural affinity alone, without fiscal justification, creates problems later.

Each region has a base currency and a general tax rate. The tax can be overridden per product category or through an external tax provider like TaxJar for the US, where each state has its own rules.

Variant prices are defined per currency, not per region. If a variant costs 450 MXN and 25 USD, those are two separate price entries. Medusa selects the correct price based on the cart region currency. If no price exists in the region currency, Medusa indicates this in the response and checkout cannot proceed.

The most common mistake is creating one global region to skip initial configuration and then trying to split it as the business grows. When that happens, historical orders stay in the original region and prices must be migrated manually.

Another frequent mistake is assuming inventory is global. Medusa manages inventory at the variant level. If you sell from different warehouses, you need the Inventory module with multiple stock locations to reserve stock per warehouse and per region.