- Which currency to charge in
- Which payment methods to show (Stripe, PayPal, Cash on Delivery)
- Which delivery options are available and at what price
- Which tax rules apply
You need at least one enabled zone before customers can complete checkout.
Accessing Zones
- Click on Settings in the sidebar
- Select Zones from the settings menu
Creating a Zone
To create a new zone:- Click the plus icon button
- Fill in the zone details
- Click Save
Zone Fields
| Field | Required | Description |
|---|---|---|
| Name | Yes | A descriptive name (e.g., “Europe”, “North America”, “Africa”) |
| Code | No | A short identifier code (e.g., “EU”, “NA”, “AF”) |
| Countries | Yes | The countries included in this zone. A country can only belong to one zone. |
| Currency | Yes | The currency used for pricing and checkout in this zone. Each zone has exactly one currency. |
| Visibility | No | Whether this zone is active. Disabled zones are not matched during checkout. |
| Payment methods | Yes | Which payment methods are available in this zone (e.g., Stripe, Cash on Delivery) |
| Carriers | Yes | Which shipping carriers serve this zone (e.g., UPS, Colissimo, Local Delivery) |
| Metadata | No | Optional key-value data for custom use |
Zone Detail Page
After creating a zone, click on it to view its detail page. The detail page shows the zone’s configuration and its shipping options.
Editing a Zone
To update a zone’s settings:- Click on the zone from the zones list
- Click the Edit button
- Modify the fields you want to change
- Click Save
What’s Configured Inside a Zone
Each zone connects three things together for a region:| What | Purpose | Where to manage |
|---|---|---|
| Countries | Which countries belong to this zone | Zone form |
| Currency | What currency customers pay in | Zone form |
| Payment methods | How customers can pay (Stripe, Cash on Delivery, etc.) | Zone form (select from available methods) |
| Carriers | Which shipping providers serve this zone | Zone form (select from available carriers) |
| Shipping options | Specific delivery options with pricing | Zone detail page (see Carriers) |
| Tax rules | Tax rates applied at checkout | Managed separately in tax settings |
Zones in Orders
When viewing orders, you can see which zone applies to each order. This helps you understand which shipping and payment rules were used.
Common Zone Setups
Single-Country Store
If you only sell domestically, create one zone:| Zone | Countries | Currency | Carriers |
|---|---|---|---|
| Domestic | Your country | Your currency | Local carriers |
Multi-Region Store
For stores selling across regions:| Zone | Countries | Currency | Carriers |
|---|---|---|---|
| Domestic | France | EUR | Colissimo, Chronopost |
| Europe | Germany, Belgium, Spain, Italy | EUR | DHL, UPS |
| North America | United States, Canada | USD | FedEx, UPS |
| Africa | Cameroon, Senegal, Ivory Coast | XAF | DHL Express |
Global Store with Few Zones
Keep it simple with broad zones:| Zone | Countries | Currency |
|---|---|---|
| Domestic | Your country | Your currency |
| International | All others | USD |
Best Practices
Start Simple
Begin with a domestic zone and expand to international zones as your business grows.
Group by Cost
Countries with similar shipping costs should share a zone to simplify pricing.
One Currency per Zone
Each zone uses one currency. If you sell in EUR and USD, you need separate zones.
Test Checkout
After configuring zones, place test orders from different countries to verify everything works.
Related Pages
Carriers
Set up shipping carriers and configure delivery options.
Currencies
Manage the currencies available in your store.
Zones Documentation
Developer reference for zones, relationships, and configuration.