Pyle

Shipping Zones ​

What This Is ​

Shipping Zones are the reusable geographic coverage groups Pyle uses to decide where a shipping service should apply.

They let operators manage delivery geography at a higher level than single postal codes.

When You Would Use It ​

Use Shipping Zones when you need to:

  • define a service area for one or more shipping services
  • exclude specific postal codes from an otherwise valid area
  • group geographic coverage so multiple shipping services can reuse it
  • add or remove individual postal codes from a zone
  • update delivery coverage in bulk

Before You Start ​

Before you work with Shipping Zones, make sure:

  • the relevant country and state are known
  • you have the correct origin ZIP if you are using radius-based coverage
  • the needed shipping postal codes already exist in the project

How To Use It In The Admin ​

Shipping Zones are managed under Settings → Shipping Zones.

Browse and filter zones ​

The index page lists all shipping zones with their country, state, radius, and postal-code count.

Use the search bar to find zones by name. Use the country and state dropdowns to narrow the list by geography. Use the postal-code filter to find zones that include a specific ZIP.

Create a zone ​

  1. Click New shipping zone.
  2. Fill in the zone name and select a country (required).
  3. Optionally select a province or state.
  4. Optionally enter a radius origin ZIP and a radius in kilometers to define geographic coverage automatically.
  5. To exclude specific ZIPs, search for a postal code and click Add ZIP. Remove an excluded ZIP at any time using the Remove ZIP button next to it.
  6. Click Create shipping zone. You are redirected to the zone's detail page.

Edit a zone ​

  1. Click on any zone in the list to open its detail page.
  2. Update the name, country, state, radius origin, or radius as needed.
  3. Click Save changes.

Changes to the radius origin or radius kilometers automatically trigger a postal-code sync in the background, recalculating which postal codes fall inside the zone.

Manage excluded postal codes ​

On the zone detail page, use the Excluded ZIPs / postal codes section to add or remove postal codes that should be left out of the zone even if they fall within the radius.

Changes to excluded ZIPs take effect immediately without a full save.

Manage included postal codes ​

The Included postal codes table shows all postal codes currently attached to the zone. Use the search field to find a specific ZIP, city, or region.

To add a postal code manually, pick it from the selector above the table and click Add postal code.

To remove a postal code, click Remove in the table row.

Preview the zone on a map ​

When the zone has a radius origin ZIP and a radius in kilometers, a map preview appears on the detail page. The map plots the origin point and the coverage circle.

To see the map preview, a Google Maps API key must be configured on the admin application (ADMIN_GOOGLE_MAPS_API_KEY). Without a key, an Open in Google Maps link is shown instead so you can check the location manually.

Delete a zone ​

On the zone detail page, click Delete and confirm. The zone is removed and you are returned to the index. Shipping services that reference the deleted zone will no longer use it for eligibility.

What It Changes In The Storefront ​

Shipping Zones are not shown to shoppers directly.

They change the storefront indirectly by deciding:

  • which shipping services are available for a destination
  • which shipping methods appear at checkout
  • which regions qualify for pickup or delivery options

Common Tasks ​

Create a new delivery region ​

Create a zone with the relevant country, state, radius origin, and radius, then attach it to the shipping services that should cover that region.

Exclude a ZIP from a large zone ​

Open the zone's detail page and add the ZIP to the Excluded ZIPs / postal codes list. The exclusion takes effect immediately.

Add a postal code that is outside the radius ​

Use the Included postal codes table to attach the postal code directly. It will be included in the zone regardless of radius coverage.

Remove a postal code you no longer want to serve ​

Find the postal code in the Included postal codes table and click Remove.

Update a service area in bulk ​

Use the shipping workbook when many zones or services need coordinated geographic updates.

Rules, Limits, And Things To Watch ​

  • A zone is not itself a shipping service. It must be attached to a service before it affects checkout availability.
  • Changing a zone without updating the services that depend on it may not produce the result you expect.
  • Radius-based zones depend on valid postal-code geography data being present in the system.
  • Excluded ZIPs take precedence over the radius calculation.
  • Deleting a zone cannot be undone.

Troubleshooting ​

A destination should be covered, but no service appears ​

Check whether the service actually uses the zone and whether another service restriction filtered it out afterward. See the Shipping Service Eligibility Checklist.

A destination should be excluded, but is still getting service ​

Check the zone's excluded ZIPs and whether another zone or a direct postal-code rule on a different service is still allowing it.

The map preview is not showing ​

Confirm that ADMIN_GOOGLE_MAPS_API_KEY is set in the admin environment. If the key is missing, the map panel will say so and offer the Open in Google Maps fallback link instead.

Sources ​

  • packages/admin/src/Livewire/Admin/Settings/ShippingZones/Page.php
  • packages/admin/src/Livewire/Admin/Settings/ShippingZones/CreateDialog.php
  • packages/admin/src/Livewire/Admin/Settings/ShippingZone/Page.php
  • packages/admin/src/Livewire/Admin/Settings/ShippingZone/PostalCodesTable.php
  • packages/framework/src/Actions/ShippingZone/ShippingPostalCode/AddShippingPostalCode.php
  • packages/framework/src/Actions/ShippingZone/ShippingPostalCode/RemoveShippingPostalCode.php
  • packages/framework/src/Models/ShippingZone.php