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

The Upload CSV drawer walks you through three steps.

1. Navigate to the Inbound page from the sidebar.
2. Click the Upload CSV button near the top of the page.
3. Download the CSV template. Two templates are offered in the drawer -- an FBA/FBM/Manual/WFS template and a Two-step template. Download whichever matches the orders you are entering.
4. Fill in one row for each item you are shipping, using the template's existing column headers.
5. Upload the file in the drawer and confirm. The system processes each row and refreshes the inbound table when it is done.

Small and medium files import in a few seconds. Files with hundreds of rows take a little longer, but you will see a confirmation once everything has been processed.

Formatting Your CSV

Always start from a downloaded template. The templates carry the exact column headers the importer expects, which is the single biggest factor in whether an upload succeeds.

Do not use an export as a template. The Export button produces a file with different column names, and the columns it contains depend on what you selected in the export modal. An exported file will not import.

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 headers are the problem, download a fresh copy of the template and copy your data into it rather than trying to rename columns in your own file.

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.

Keep a blank copy of each template on hand. 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.