Import your catalog items with a CSV file—no channel integration required.
CSV import is one of the three ways to build your Verified Account catalog. It's the option for shippers who don't sell through a supported channel like Etsy, eBay, or WooCommerce, or who keep product data in a spreadsheet rather than a system that can be connected to Zonos. It's also the fastest way to get an existing catalog loaded in one pass, and it doesn't require a developer—if you can export a spreadsheet, you can build your catalog.
Imported items go through the same PGA checks as channel-synced items, so your U.S.-bound shipments stay compliant either way. Keep in mind that a CSV is a point-in-time upload: as your products change, you'll re-import to keep your catalog current.
If you'd rather write items programmatically from your own system, the Catalog API is the third option.
Matching orders to catalog items: This is the order Zonos uses to match, not a list of required fields. When your orders and tracking numbers are imported later, Zonos links each order line back to a catalog item by Product ID first, then SKU, and finally Name. Keep whichever identifiers your items use accurate and consistent between your catalog and your orders. This behavior is still being finalized and may change before launch.
Very little is strictly required. A few optional fields make a real difference to whether Zonos can screen your products properly, so include them if you have them.
Priority↕
Fields↕
Why↕
Required
Name, plus a SKU or a product ID (or both)
A row without these cannot be imported.
Strongly recommended
Country of origin, HS code
These drive duty calculation and U.S. agency screening. Several Zonos checks depend on country of origin, so an item missing it may not be flagged when it should be. Leave the HS code blank and Zonos classifies the item from its name and description.
Optional
Description, weight and unit, price and currency, image URL
Helpful, but not needed. A factual description improves classification when you have not supplied an HS code.
You do not need complete data on day one. Start with what you have, then re-upload to fill the gaps—an item with the same SKU or product ID updates in place rather than creating a duplicate.
Match your product details to the template columns. At minimum, each item needs a SKU or product ID and a name.
Save your file as a CSV.
Drag and drop your CSV file into the import dialog, or click to browse for it.
Review your uploaded items and correct any fields flagged with errors.
Click Import.
Note: If you upload an item with the same SKU or product ID as an existing item, the new row updates the existing item rather than creating a duplicate.
After the import completes, PGA screening runs automatically in the background. A Needs attention badge appears next to any item that needs more information—it can take a few moments to show up for newly imported items.
CSV columns
Each row represents one item. The template includes additional optional fields—see Product CSV import for the full list. For Verified Account catalog and PGA screening, these are the most important columns:
Column↕
Required↕
Description↕
SKU
Required*
Your unique identifier for the item. *Each item needs a SKU or a product ID (or both). Used to match imported orders and tracking numbers when an item has no product ID.
Product ID
Required*
Your platform's identifier for the item. *Each item needs a SKU or a product ID (or both). The identifier Zonos matches imported orders and tracking numbers against first.
Name
Required
The item's name, e.g., Men's leather wallet. Used as a fallback to match imported orders and tracking numbers when an item has no product ID or SKU—keep it accurate and consistent.
Country of origin
Recommended
The 2-letter ISO code for the country where the item was manufactured, e.g., VN. Highly recommended: several Zonos checks depend on it, so items without it may not be flagged.
Universal HS code
Recommended
The item's universal, 6-digit HS code, e.g., 4202.31. If left blank, Zonos classifies the item from its name and description.
Description
Optional
A detailed, factual description of the item, including what it is, its material, and its purpose. Used for classification and PGA screening.
Weight
Optional
The item's weight as a number, e.g., 0.2.
Weight unit
Optional
The unit for the weight value: pound, ounce, kilogram, or gram. Required when you provide a weight.
Price
Optional
The item's price as a number, e.g., 49.99.
Currency
Optional
The 3-letter ISO code for the price currency, e.g., USD. Required when you provide a price.
Image URL
Optional
A publicly accessible URL for the item's image.
Common import errors
Error↕
Description↕
Missing column header(s)
Your file is missing one or more of the template's column headers. Re-download the template and match its headers exactly.
Unrecognized column header(s)
Your file contains a column header that isn't in the template. Remove or rename the column.
Missing SKU or product ID
A row has neither a SKU nor a product ID. Add at least one so the item can be identified.
Invalid HS code
The HS code isn't valid. Universal HS codes must be at least 6 digits, e.g., 4202.31.
Invalid country code
The country of origin isn't a valid 2-letter ISO code.
File isn't a CSV
The uploaded file isn't in CSV format. Save your spreadsheet as a .csv file and try again.
CSV import
CSV import
Import your catalog items with a CSV file—no channel integration required.
CSV import is one of the three ways to build your Verified Account catalog. It's the option for shippers who don't sell through a supported channel like Etsy, eBay, or WooCommerce, or who keep product data in a spreadsheet rather than a system that can be connected to Zonos. It's also the fastest way to get an existing catalog loaded in one pass, and it doesn't require a developer—if you can export a spreadsheet, you can build your catalog.
Imported items go through the same PGA checks as channel-synced items, so your U.S.-bound shipments stay compliant either way. Keep in mind that a CSV is a point-in-time upload: as your products change, you'll re-import to keep your catalog current.
If you'd rather write items programmatically from your own system, the Catalog API is the third option.
What each item needs
Very little is strictly required. A few optional fields make a real difference to whether Zonos can screen your products properly, so include them if you have them.
You do not need complete data on day one. Start with what you have, then re-upload to fill the gaps—an item with the same SKU or product ID updates in place rather than creating a duplicate.
Import your items
In Dashboard, go to Catalog.
Select Manage, then Import products.
Download the sample CSV template from the import dialog. Verified Account catalog import uses the same template as Product CSV import.
Match your product details to the template columns. At minimum, each item needs a SKU or product ID and a name.
Save your file as a CSV.
Drag and drop your CSV file into the import dialog, or click to browse for it.
Review your uploaded items and correct any fields flagged with errors.
Click Import.
After the import completes, PGA screening runs automatically in the background. A Needs attention badge appears next to any item that needs more information—it can take a few moments to show up for newly imported items.
CSV columns
Each row represents one item. The template includes additional optional fields—see Product CSV import for the full list. For Verified Account catalog and PGA screening, these are the most important columns:
pound,ounce,kilogram, orgram. Required when you provide a weight.Common import errors
.csvfile and try again.Was this page helpful?