Troubleshoot: Error uploading CSV file

Created:   |   Updated:

Before getting started:

Be sure you have the correct data set to troubleshoot. To download the original CSV file, go the REPORTS >> UPLOADS page and click the name of the CSV to download it.

Sometimes errors can occur when importing a CSV file into ShippingEasy. There are a few reasons why this may happen:

The spreadsheet you have uploaded is not in .CSV format

To solve this issue, you must re-save your spreadsheet in a format that we can accept - a CSV file.

To change the extension on your file in Excel for WINDOWS: 
  • If you use Excel, and you want to change the format on a case-by-case basis, please see this article from Microsoft Office.
  • If you use Excel, you can also change the default of the file type by viewing this article by Microsoft Office.
To change the extension on your file in Excel for MAC:
  • Open the file you want to save
  • On the File menu, click Save As.
  • In the Save As box, type a name for the file.
  • On the Format pop-up menu, make sure either comma separated (.csv) option is selected (there should be an option for Windows and DOS).
  • Click Save.

The spreadsheet is saved using incorrect "Field options"

When saving CSV files, you are presented with a number of "Field options", which determines how the data is stored:

  • Character set: how the characters are encoded
  • Field delimiter: how the fields are separated
  • Text delimiter: how the field contents of the field are denoted
We recommend setting the Field options as follows:
  • Character set: Unicode (UTF-8)
  • Field delimiter: ,
  • Text delimiter: '

If you are not presented with the option to set the Field options when saving your file, try saving it as an XLS or ODS format first. Then save the spreadsheet again as a CSV file.

The spreadsheet is hiding columns or rows

Sometimes columns or rows can get hidden on accident or we forget to unhide them. This can cause some issues when uploading a CSV as the information is technically there. If you have hidden data, unhide everything on the spreadsheet and delete unneeded content.

Instructions for WINDOWS: 
Instructions for MAC:

Open Excel and go to Format > Sheet > Unhide. This will reveal everything on the page.

The spreadsheet or title may contain foreign or random characters

Sometimes the customers we ship to, especially foreign customers, will enter characters in their order that do not meet the upload requirements. For instance, anything in Chinese characters will not be accepted nor will any punctuation such as exclamation points or question marks .

Additionally, the title of the .CSV may be what is causing the issue. Try to keep the title as simple as possible with no special characters.

One or more column headers are blank

If a column header is blank, all of the columns that have contain data but do no have a header will mapped to that column. To avoid this, make sure any columns that contain data also have a header.


Related articles:

Sample CSV for uploading
How To: Check CSV uploads for duplicates and delete them
ShippingEasy column mapping for CSV - required fields & explanations


Please sign in to leave a comment.

Community    browse  


Questions & Answers

Issues & Bugs