Regions are essential to your Medusa ecommerce store. They represent different countries or regions your ecommerce store serves customers in. This overview introduces the available features related to regions and currencies.
Multi-Region Support and Management
In Medusa, you can create an unlimited number of regions. A region can be associated with one or more country.
For example, you can create a region to represent the European region, and associate European countries with that region. You can also create a region that represents each of these countries on their own.
Each region can have its own settings such as the currency, payment processors, tax providers, and more.
Learn how to manage regions using the Admin APIs.
Learn how to view and manage regions in Medusa Admin.
A currency can be associated with one or more regions. When setting prices for products, you can specify a price per currency and per region.
You have complete control over the format and value of the price of a product per currency and per region. This flexibility removes the restriction of being tied to a predefined conversion rate, which often leads to prices badly-formatted on the storefront.
Learn how to manage currencies using the Admin APIs.
Learn how to manage available currencies in Medusa Admin
Region Switcher in the Storefront
Your customers can choose the region that matches their location. This would automatically show the correct product prices to the customer with the currency of that region.
During checkout, customers will only see the available shipping options and payment processors in their region. Taxes are also calculated based on that region. This ensures a seamless checkout experience tailored for every region.
Learn how to display and use Regions in the storefront.
Check available Store REST APIs for Regions.
Understand the Architecture
Learn how Regions and Currencies are built, their relation to other modules, and more.
Learn about the Region Architecture.
Learn about the Currency Architecture.
Discover Regions and Currencies' relation to other modules in Medusa.
Manage tax providers per region. Integrate third-party tax providers.
Show a personalized checkout experience based on the region selected.