> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laravelshopper.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Shipping Zones

> Define where you ship, which currencies you accept, and which payment and delivery methods are available.

A shipping zone is a group of countries that share the same currency, payment methods, and delivery options. For example, you might have a "Europe" zone with EUR currency and Colissimo/DHL delivery, and a "North America" zone with USD currency and UPS/FedEx delivery.

Zones are central to how your store operates. When a customer checks out, Shopper matches their shipping address to a zone and uses it to determine:

* 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

<Note>
  You need at least one enabled zone before customers can complete checkout.
</Note>

## Accessing Zones

1. Click on **Settings** in the sidebar
2. Select **Zones** from the settings menu

<Frame caption="Zones settings page">
  <img src="https://mintcdn.com/shopperlabs-ee054f5e/3ZB91-BonuCgmULq/images/v2/starterkit-zones.png?fit=max&auto=format&n=3ZB91-BonuCgmULq&q=85&s=6bce5efd285ccf3f74de8764651cd0d3" alt="Shipping Zones list" width="3414" height="1664" data-path="images/v2/starterkit-zones.png" />
</Frame>

The zones page shows all your configured zones. Click on a zone to view its details, shipping options, and connected carriers.

## Creating a Zone

To create a new zone:

1. Click the **plus icon** button
2. Fill in the zone details
3. Click **Save**

<Frame>
  <img src="https://mintcdn.com/shopperlabs-ee054f5e/KQY6o7d4neR-LyIr/images/v2/add-zone.png?fit=max&auto=format&n=KQY6o7d4neR-LyIr&q=85&s=81f381db6d324ff7d5751f84c153b72d" alt="Create zone form" width="3438" height="1994" data-path="images/v2/add-zone.png" />
</Frame>

### 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                                                       |

<Tip>
  Countries already assigned to another zone are grayed out in the country selector. Each country can only belong to one zone.
</Tip>

## 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.

<Frame>
  <img src="https://mintcdn.com/shopperlabs-ee054f5e/3ZB91-BonuCgmULq/images/v2/starterkit-enable-zone.png?fit=max&auto=format&n=3ZB91-BonuCgmULq&q=85&s=8039ca8f8526109f37039a63b79e5c63" alt="Zone detail page" width="708" height="186" data-path="images/v2/starterkit-enable-zone.png" />
</Frame>

## Editing a Zone

To update a zone's settings:

1. Click on the zone from the zones list
2. Click the **Edit** button
3. Modify the fields you want to change
4. Click **Save**

You can change the zone's name, code, countries, currency, payment methods, and carriers at any time.

<Warning>
  Changing a zone's currency affects how prices are displayed to customers in that region. Make sure you have [prices](/v2/user-guide/marketing/pricing) configured in the new currency before switching.
</Warning>

## 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](/v2/user-guide/store-setup/carriers)) |
| **Tax rules**        | Tax rates applied at checkout                          | Managed separately in tax settings                                     |

<Tip>
  You need to create [carriers](/v2/user-guide/store-setup/carriers) and payment methods before you can assign them to a zone. Set those up first, then create your zones.
</Tip>

## 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.

<Frame>
  <img src="https://mintcdn.com/shopperlabs-ee054f5e/3ZB91-BonuCgmULq/images/v2/orders-with-zone.png?fit=max&auto=format&n=3ZB91-BonuCgmULq&q=85&s=7547b47aed3df35c623bbc2dcd545689" alt="Orders showing zone information" width="2812" height="394" data-path="images/v2/orders-with-zone.png" />
</Frame>

## 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

<CardGroup cols={2}>
  <Card title="Start Simple" icon="rocket">
    Begin with a domestic zone and expand to international zones as your business grows.
  </Card>

  <Card title="Group by Cost" icon="calculator">
    Countries with similar shipping costs should share a zone to simplify pricing.
  </Card>

  <Card title="One Currency per Zone" icon="coins">
    Each zone uses one currency. If you sell in EUR and USD, you need separate zones.
  </Card>

  <Card title="Test Checkout" icon="vial">
    After configuring zones, place test orders from different countries to verify everything works.
  </Card>
</CardGroup>

## Related Pages

<CardGroup cols={3}>
  <Card title="Carriers" icon="truck" href="/v2/user-guide/store-setup/carriers">
    Set up shipping carriers and configure delivery options.
  </Card>

  <Card title="Currencies" icon="coins" href="/v2/user-guide/store-setup/currencies">
    Manage the currencies available in your store.
  </Card>

  <Card title="Zones Documentation" icon="code" href="/v2/zones">
    Developer reference for zones, relationships, and configuration.
  </Card>
</CardGroup>
