Upload CSV

When you have a large batch of inbound shipments to enter, typing each one manually can be time-consuming. The Upload CSV feature lets you prepare all of your shipment data in a spreadsheet and import it in one step, saving you significant time and reducing repetitive data entry.

How to Upload a CSV

Follow these steps to import your shipments from a CSV file.

1. Navigate to the Inbound page from the sidebar.
2. Click the Upload CSV button near the top of the page.
3. A file picker will appear. Select the CSV file from your device that contains your shipment data.
4. Confirm the upload when prompted. The system will begin processing each row in the file.
5. Wait for the result notification. A success toast will appear when all rows have been imported, and the inbound table will refresh to display the new shipments.

The entire process usually takes just a few seconds for small to medium files. Larger files with hundreds of rows may take a bit longer, but you will see the confirmation once everything has been processed.

Formatting Your CSV

Getting the format right is the most important part of a successful upload. Here are some guidelines to follow when preparing your file.

Use consistent column headers that match the field names the system expects. If you have previously exported your inbound data using the Export button on the inbound page, that exported file is a good template to follow since it already has the correct headers and formatting.

Keep all quantity values numeric. Avoid entering text like "ten" or including units such as "10 pcs" in quantity columns. The system expects plain numbers and will reject rows that contain non-numeric values in numeric fields.

Validate your SKU and ASIN values before uploading. A mistyped ASIN can lead to the wrong product being associated with a shipment, which creates problems downstream during prep and labeling. Double-check these identifiers against your Amazon listings or supplier records.

Make sure your CSV is saved with UTF-8 encoding, especially if product names contain special characters or accented letters. Most spreadsheet applications default to UTF-8, but it is worth confirming if you run into unexpected characters after upload.

Troubleshooting Upload Errors

If the upload fails, the system will display an error toast explaining what went wrong. Common issues include mismatched column headers, invalid data types in certain fields, or missing required values.

When you encounter an error, read the message carefully. It will usually point you to the specific rows or columns that caused the problem. Open your CSV, correct the flagged rows, save the file, and try the upload again.

A good troubleshooting strategy is to test with a minimal CSV containing just one or two rows. This lets you confirm that your headers and formatting are correct before uploading the full batch. Once the small test file imports successfully, you can upload the complete file with confidence.

If you continue to have trouble, export a sample of your existing inbound data using the Export button and compare its structure to your upload file. Matching the export format is the fastest way to resolve formatting issues.

Best Practices

Prepare your CSV in a dedicated spreadsheet application rather than a plain text editor. Spreadsheet tools like Excel or Google Sheets handle CSV formatting, encoding, and data validation more reliably.

Before uploading a large file, back up your current inbound data by clicking the Export button on the inbound page. This gives you a snapshot you can reference if anything looks off after the import.

Keep a master template CSV on hand with the correct headers and a sample row. When you need to prepare a new upload, duplicate the template and fill in your data. This avoids header typos and formatting inconsistencies across uploads.