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
  • exclude specific ZIPs from an otherwise valid area
  • group geographic coverage so multiple shipping services can reuse it
  • 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

In the shared package, shipping zones are mainly managed through the shipping Excel workflow or project-specific internal tools rather than a packaged settings page.

How To Use It In The Admin ​

  1. Use the shipping Excel export or your project’s admin API workflow to review the current zones.
  2. Create or update the zone with:
    • name
    • country
    • optional state
    • radius origin ZIP
    • radius in kilometers
    • excluded ZIPs
  3. Save or import the updated zone data.
  4. Attach the zone to the shipping services that should use it.
  5. Re-check a storefront shipping estimate or order shipment to confirm the expected service availability.

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 and attach it to the services that should cover that region.

Exclude a ZIP from a large zone ​

Use excluded ZIPs when most of the area is valid but specific destinations are not.

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

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.

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

Check the zone’s excluded ZIPs and whether another zone or direct postal-code rule is still allowing the service.

  • Shipping Services
  • Shipping postal-code data
  • Shipping configuration import and export

Sources ​

  • packages/framework/src/Http/Controllers/Api/Admin/ShippingZonesController.php
  • packages/framework/src/Actions/Exports/Shipping/Sheets/ShippingZonesSheet.php
  • packages/framework/src/Actions/Import/Shipping/Sheets/ShippingZonesImportSheet.php
  • packages/framework/src/Models/ShippingZone.php