A Zone groups one or more countries or regions into a named set that can be referenced by other parts of the system. Zones are the geographic building blocks that Vendure uses to determine which tax rates apply and which shipping methods are available.
A Zone is simply a name and a collection of Country (or Region) members. For example:
A country can belong to multiple zones. For example, Germany could be in both an "EU" zone and a "DACH" (Germany, Austria, Switzerland) zone.
Zones are a core part of tax configuration. A tax rate in Vendure is defined as a combination of:
This means you can define different tax rates for the same type of product depending on the customer's geographic zone. For example, "Standard" goods might be taxed at 20% in the "UK" zone but 19% in the "Germany" zone.
The active zone for tax calculation is determined by the TaxZoneStrategy. By default, Vendure uses the channel's default tax zone, but you can configure it to use the customer's shipping address instead with the AddressBasedTaxZoneStrategy.
Shipping methods use zones to determine eligibility. A shipping method can be restricted to specific zones, so it only appears as an option when the customer's shipping address falls within one of those zones. For example, a "Free Domestic Shipping" method might be limited to the "Domestic" zone, while "International Express" applies to a "Rest of World" zone.
Each Channel has two zone-related settings:
These defaults are especially important for storefronts that display tax-inclusive prices on product listing pages, where the customer's actual location is not yet known.
Zones are managed through the Admin API or the Admin UI. When you create or update a zone, you specify its name and assign country members. Changes to zone membership take effect immediately for new orders, but do not retroactively affect existing orders that were placed under the previous zone configuration.
Vendure ships with a set of commonly-used countries pre-defined. You can enable or disable countries and organize them into zones as needed for your business during initial setup or at any time afterwards.
Single-country store — Create one zone containing your home country and use it as both the default tax zone and default shipping zone for your channel.
Regional setup — Create zones for each region you serve (e.g., "EU", "North America", "Asia-Pacific") with appropriate tax rates and shipping methods for each. Use the AddressBasedTaxZoneStrategy so that tax is calculated based on the customer's address.
Marketplace — In a multi-channel marketplace, each seller's channel can have its own default zones, reflecting where that seller operates and ships to.
Architecture reviews, custom plugin work, migrations, ongoing support. Get a hand from the team that builds Vendure.
Talk to the team