Pyle

How to Export and Import Shipping Configuration ​

What This Task Does ​

This task uses the shipping workbook to review and update shipping zones and shipping services in bulk.

Use it when you need to change geographic coverage, pricing, or service restrictions across more than a few records.

Before You Start ​

Make sure:

  • you know which shipping records need to change
  • you understand that the shared package manages shipping configuration mainly through the shipping workbook rather than a packaged settings page
  • you are comfortable editing workbook columns carefully

Steps ​

  1. Go to Tools > Excel.
  2. Export the shipping report.
  3. Open the workbook and review at least these sheets:
    • shipping_zones
    • shipping_services
  4. Update shipping_zones when you need to change:
    • name
    • country or state
    • radius ZIP origin
    • radius in kilometers
    • excluded ZIPs
  5. Update shipping_services when you need to change:
    • method and location UUIDs
    • price and currency
    • delivery-day range
    • shipping zones
    • product, customer, or geography restrictions
    • free-shipping or priority flags
  6. Save the workbook.
  7. Run the matching import flow from Tools > Excel for shipping zones or shipping services.
  8. Re-check a shipping estimate or order shipment to confirm the result.

What Happens Next ​

After a successful import:

  • shipping-zone geography can change
  • shipping-service eligibility can change
  • storefront shipping estimates can change
  • order shipment choices can change

Common Mistakes ​

  • Editing the wrong sheet.
  • Breaking UUID references between services, methods, and inventory locations.
  • Forgetting that a service can still be filtered out later even if it imports successfully.
  • Ignoring workbook column-name differences for excluded product-type fields.

Sources ​

  • packages/admin/src/Livewire/Admin/Tools/Excel/ExportDialog/ShippingExport.php
  • packages/admin/src/Livewire/Admin/Tools/Excel/ImportDialog/ShippingServicesImport.php
  • packages/admin/src/Livewire/Admin/Tools/Excel/ImportDialog/ShippingZonesImport.php
  • packages/framework/src/Actions/Exports/Shipping/ShippingTemplatesExport.php
  • packages/framework/src/Actions/Import/Shipping/Sheets/ShippingServicesImportSheet.php
  • packages/framework/src/Actions/Import/Shipping/Sheets/ShippingZonesImportSheet.php