Back to Home

Import Item Library Troubleshooting

If you have trouble importing your item library, you may be experiencing an issue with your Excel (.xlsx) or Comma Separated Value (CSV) spreadsheet.

Troubleshoot Item Import Tool

General Formatting

Try these troubleshooting steps to resolve common formatting issues:

  • Make sure you’re using the most up to date template from your Square Dashboard. To access it, visit Items > click Actions > Import Library and select your option > click Next > Download our template.
  • Be sure to save the file as a .xlsx or .csv. The item import tool won’t work with XLS, XLSM or any other file type.
  • When editing the template, don’t change any information in the Token column or delete any empty columns.
  • Don’t change the file name.
  • Remove any commas from text you’ve added to the file (you can add them back to your item names, descriptions or modifiers once they’ve been imported to your library).
  • Double check that all of your items have unique names.

If you’re transferring item libraries between Square accounts, tax rates and modifiers must be manually created for the new library.

Number of Items

The item import tool can support up to 30,000 items. If you need to upload over 30,000 items, contact us for assistance.

Browser

For best results, use a supported browser, such as Google Chrome, Mozilla FireFox, Safari 6 or later, or Internet Explorer 10 or later. If you have trouble with your browser, try the following troubleshooting tips.

SKU Errors

If you’re using the CSV file format and receive a SKU error, check your import file to see if data in the SKU column is formatted in scientific notation, e.g. 2.68435E+17. If you see this, take the following steps:

  1. With the item import CSV open, select the SKU column so the entire column is highlighted.
  2. Right-click on the column > select Format Cells.
  3. Select Number > and change the decimal places to 0.
  4. Click OK.
  5. Click FileSave As, and make sure the file format is saved as Comma Separated Values (CSV).
  6. Click Save.
  7. Import this new file to your online Square Dashboard.

SKU Formatting

Note: The following only applies if importing using a .csv file format, not Excel (.xlsx).

While you are able to import the CSV data into a spreadsheet, if your item library contains SKUs do not open the CSV file directly as some spreadsheet editors (i.e. Excel, Numbers, ets.) will modify your SKUs in unexpected ways. For instance, the spreadsheet editor may remove leading 0s (ex. 0012345 will become 12345) or convert your SKUs to scientific notation (ex. 12345678999 will become 1.2346E+10).

While we recommend avoiding the use of SKUs that contain leading 0s, below are some tips to help you with common formatting issues.

Import CSV data in Microsoft Excel

  1. Create a new spreadsheet in Microsoft Excel.
  2. Select File and Import from the main menu.
  3. Select CSV File and click Import.
  4. Choose the CSV file that you exported from your item library and click Get Data.
  5. Your Import Wizard pop up will appear.
    • Click Next and ensure that only the Comma Delimiter is checked, click Next again.
    • Scroll over to the SKU column (click to select the SKU column) and change the column data format to Text.
    • Press Finish.
      CSV Formating
  6. Choose the New Sheet option and press OK to complete the import.

Import/Export File Format

Square uses Excel (.xlsx) and a comma separated value (.CSV) format file to support bulk importing and exporting of your item library and inventory.

Note: The file format for Import/Export has changed to support more complexity in your item library and improve support for multiple locations.

Importing using the outdated template is no longer supported. Before you attempt to import changes to your library it is recommended you export a new copy of your item library in the new file format.

Refer to the Export File Field Descriptions table above for more details about the columns in your Import/Export file format.

Note: If you are attempting to transfer libraries between accounts, there are some additional steps you will need to take.