Import orders with CSV
Updated 2026-09-07
On this page
CSV import turns a spreadsheet of shipments into Nitromule orders you can rate shop and label.
Steps
- Open Orders → CSV import (or the CSV entry under Stores).
- Download the official template — column names matter.
- Fill one row per shipment (or per package rules your template documents).
- Required fields typically include name, address lines, city, state, ZIP, weight, and dimensions.
- Export/save as
.csv. - Upload the file.
- Map columns if the importer asks.
- Resolve error rows (blank ZIP, zero weight, invalid state).
- Confirm new orders in Incomplete.
- Get rates and Create Label on each order.
Common import errors
| Error | Fix |
|---|---|
| Missing ZIP / postal | Fill postal code |
| Invalid weight | Use numeric pounds/ounces per template |
| Bad state/province | Use standard codes |
| Duplicate order numbers | Change external ids or skip duplicates |
After import
- Buy from the order so your records stay tied together
- For connected stores, prefer sync over CSV to avoid doubles — stores FAQ
- Bulk select when packaging is similar — bulk labels