How do I import orders from a spreadsheet (.CSV)?

Click either link below for further details specific to the EasyRoutes product you're using:


EasyRoutes for Shopify

Need to add orders from outside of Shopify or orders that you are already delivering that you are tracking on a spreadsheet? Learn how to use our Address Book feature to upload these orders onto EasyRoutes - now featuring support for importing up to 15 CSV files of order data in a single batch.

Note: Delivery notifications are sent to manual stops only via Easyroutes Custom notifications, which requires our Premium plan. You can also consider using Draft Orders.

1. To begin, click on the "Address book" button above the map on the EasyRoutes Home Screen to start the import process.

Note: if you already have a CSV prepared for import, you can bypass the Address Book dialog by clicking the dropdown next to it and selecting "Import and add orders", then skip to Step 3 below:

2. Create your .CSV File

Next, you will need to upload a formatted .CSV file containing the deliveries that you wish to import. 

If you need a fresh template, download this sample spreadsheet template (available as an .XLSX template or a .CSV template) as a starting point for creating your orders list.

Your CSV file must include a header row, must contain at least one column where the  delivery addresses for each stop or order are provided in the following format: Street Number and Name, Unit Number (if applicable), City, State/Province (if applicable), Country (e.g. 123 Main Street, San Francisco, CA, 94110, United States). 
The address information needs to be provided in one column and in the format provided above for Google Maps to validate the addresses and locations correctly.

We also currently provide support for importing First Name, Last Name, Company, Email, Phone, Note, Delivery Date, Time Window (customer's preferred delivery timeframe), Stop Time (how long to spend at a particular stop), Priority status, Latitude, Longitude (both values must be included to properly parse), and Order name as independent, optional columns for all orders. You can also include item details for each stop - full details below.

Here's a sample of what this looks like:

If you have a spreadsheet already, "Save As..." or Export your spreadsheet as a CSV file (e.g. Comma-separated values (.csv, current sheet) for creating the file that you need to upload.

To export a CSV from Google Sheets, follow these steps:

  1. Open the Google spreadsheet that contains the data that you want to export
  2. Click on the tab that has the data to be exported (CSV files only contain one spreadsheet tab)
  3. On the top toolbar, click "File". A drop-down menu will appear
  4. Click "Download", and another menu will appear
  5. Click "Comma-separated values (.csv, current sheet)"

To export a CSV from Microsoft Excel, follow these steps using the "Save As..." command:

  1. Go to File > Save As.
  2. Click Browse.
  3. In the Save As dialog box, under Save as type box, choose the text file format for the worksheet; for example, click Text (Tab delimited) or CSV (Comma delimited).
  4. Browse to the location where you want to save the new file, and then click Save.

To export a CSV from the Apple Numbers app, follow these steps:

  1. Open the spreadsheet, then choose File > Export To > [ file format] from the File menu at the top of your screen.
    The File menu open with Export To selected, with its submenu showing export options for PDF, Excel, CSV, and Numbers ’09.
  2. Specify export settings:
    • Select CSV: Cell contents are shown as values separated by commas in the exported file. Choose whether to create a file for each table or combine tables into a single file. 
    • Select the "Include table names" checkbox. Ensure the text encoding is UTF-8, you can check this click the disclosure arrow next to Advanced Options.
  3. Click Next, then type a name for the spreadsheet (without the filename extension, such as .xls or .csv, which is appended to the name automatically).
  4. Enter one or more tags (optional).
  5. To choose where to save the spreadsheet, click the Where pop-up menu, choose a location, then click Export.

    To see more locations, click the arrow next to the Where pop-up menu.

If you need a fresh template, download our sample spreadsheet template (available as an .XLSX template or a .CSV template) as a starting point for creating your orders list and exporting the needed .CSV file as per above.

If you are exporting your orders from another data-source, review your supporting documentation for how to create these .CSV files. Note that if you're importing more than one spreadsheet at once (up to 15 CSV files are supported per upload), column titles across all imported spreadsheets must match.

Once you are ready, from the Address book, click on the "Import history" tab, then click the "Import new CSV" button:

3. Upload your CSV File

Select and upload your formatted .CSV file using the "Add file" button, or drag and drop your .CSV file into the card as prompted:

4. Select Columns for Import

If you upload a spreadsheet in the same format as one that was successfully imported and added to the map, EasyRoutes will remember your previous mapping from the last time.

Once you have uploaded your spreadsheet, you'll need to map the columns on the next screen. You will see a screen where you can choose the import method, and a list of columns that you can import:

If you have your address stored in multiple columns in your CSV, then click on "Provide the address using multiple fields" - here's an alternate sample spreadsheet (available as an .XLSX template or a .CSV template) with addresses formatted in this manner. You will see more address columns available for mapping to your spreadsheet:

For each of the fields, click on "Select a column" and map it to the appropriate column from your spreadsheet. You must map one column to the Delivery Address to proceed.

Once you have completed mapping. Click on Next in the top right corner.

Note: If you see an error, then your spreadsheet or .CSV file is not provided in the expected format that we have described above. If you need a fresh template, download our sample spreadsheet template (available as an .XLSX template or a .CSV template) as a starting point for creating your orders list and exporting the needed .CSV file as per above. If your CSV is storing the address fields in multiple columns, then you must ensure you have mapped every column in the process above. To note, you must ensure that you are including the following in either method: Street Number and Name, Unit Number (if applicable), City, State/Province (if applicable), Country (e.g. 123 Main Street, San Francisco, CA, 94110, United States). 

5. Review and confirm your Import

You may also review and remove certain orders from being imported at this step first by using the checkbox(es) and selecting "Remove stop" from the Actions menu that pops up:

Click on Finish import in the top right corner to proceed when you are ready - this will add all imported entries into your Address Book.

To add imported stops directly to the map, select Import and add stops to map instead - this will add all imported entries into your Address Book and add them directly to the map for immediate use in routes:

All CSV files imported to date can be accessed from the "Import history" tab of the Address book. Click the eye icon to the right of any import to view a list of stops that are associated with each imported CSV:

From here, click "Add all to custom stops" to migrate the imported data from this CSV into the Custom stops tab of the address book for quick addition to routes:

The address book will be sorted alphabetically by a customer's last name. Frequently used entries can be pinned to the top of the address book by clicking the star icon to the left of any entry's name:

From the "Import history" tab, any previously imported CSVs can be deleted or renamed by clicking the "Action" (three dots) menu:

Importing Stop Items

Your imported stops may include items with an associated Quantity, Name, and Weight (per item) specified by individual columns. To import an order with multiple different types of items, just add additional rows for each additional item and leave the other columns blank. Then select the Group adjacent items across blank rows into a single delivery stop checkbox when importing to associate the adjacent item rows with the preceding stop:

Here is an example spreadsheet showing an order with multiple item rows:

When the example spreadsheet shown above is imported into EasyRoutes, customers and items will be parsed as follows:

  • Michael Gauthier: 5x Skateboard, 1x Baseball Hat, 2x Sunglasses; Total Weight: 12.7kg
  • Liam Anderson: 1x Basketball; Total Weight: 600g
  • Barry Cook: 10x Hockey Puck; Total Weight: 1.7kg

EasyRoutes for Web

Before using EasyRoutes for Web to generate optimized delivery routes, you'll need to upload a CSV file containing the details of your orders into your Address Book. Note that you can bulk upload up to 15 separate CSV files in one upload operation.

1. To begin, access your EasyRoutes Dashboard, where you'll find the Import CSV drop zone at the top of the page:

2. Create your .CSV File

Next, you will need to upload a formatted .CSV file containing the deliveries that you wish to import. 

If you need a fresh template, download this sample spreadsheet template (available as an .XLSX template or a .CSV template) as a starting point for creating your orders list.

Your CSV file must include a header row, must contain at least one column where the  delivery addresses for each stop or order are provided in the following format: Street Number and Name, Unit Number (if applicable), City, State/Province (if applicable), Country (e.g. 123 Main Street, San Francisco, CA, 94110, United States). 
The address information needs to be provided in one column and in the format provided above for Google Maps to validate the addresses and locations correctly. We also currently provide support for importing First Name, Last Name, Company, Phone Number, Email, Note, Delivery Date, Time Window (customer's preferred delivery timeframe), Stop Time (how long to spend at a particular stop), Priority status, Latitude, Longitude (both values must be included to properly parse), and Order name as independent, optional columns for all orders. You can also include item details for each stop - full details below.
Here's a sample of what this looks like:

If you have a spreadsheet already, "Save As..." or Export your spreadsheet as a CSV file (e.g. Comma-separated values (.csv, current sheet) for creating the file that you need to upload.

To export a CSV from Google Sheets, follow these steps:

  1. Open the Google spreadsheet that contains the data that you want to export
  2. Click on the tab that has the data to be exported (CSV files only contain one spreadsheet tab)
  3. On the top toolbar, click "File". A drop-down menu will appear
  4. Click "Download", and another menu will appear
  5. Click "Comma-separated values (.csv, current sheet)"

To export a CSV from Microsoft Excel, follow these steps using the "Save As..." command:

  1. Go to File > Save As.
  2. Click Browse.
  3. In the Save As dialog box, under Save as type box, choose the text file format for the worksheet; for example, click Text (Tab delimited) or CSV (Comma delimited).
  4. Browse to the location where you want to save the new file, and then click Save.

To export a CSV from the Apple Numbers app, follow these steps:

  1. Open the spreadsheet, then choose File > Export To > [ file format] from the File menu at the top of your screen.
    The File menu open with Export To selected, with its submenu showing export options for PDF, Excel, CSV, and Numbers ’09.
  2. Specify export settings:
    • Select CSV: Cell contents are shown as values separated by commas in the exported file. Choose whether to create a file for each table or combine tables into a single file. 
    • Select the “Include table names” checkbox. Ensure the text encoding is UTF-8, you can check this click the disclosure arrow next to Advanced Options.
  3. Click Next, then type a name for the spreadsheet (without the filename extension, such as .xls or .csv, which is appended to the name automatically).
  4. Enter one or more tags (optional).
  5. To choose where to save the spreadsheet, click the Where pop-up menu, choose a location, then click Export.

    To see more locations, click the arrow next to the Where pop-up menu.

If you need a fresh template, download our sample spreadsheet template (available as an .XLSX template or a .CSV template) as a starting point for creating your orders list and exporting the needed .CSV file as per above.

If you are exporting your orders from another data-source, review your supporting documentation for how to create these .CSV files. 

3. Upload your CSV File

Select and upload your formatted .CSV file using the "Import new CSV" button, or drag and drop your .CSV file into the Dashboard drop zone as prompted:

4. Select Columns for Import

If you upload a spreadsheet in the same format as one that was successfully imported and added to the map, EasyRoutes will remember your previous mapping from the last time.

Once you have uploaded your spreadsheet, you'll need to map the columns on the next screen. You will see a screen where you can choose the import method, and a list of columns that you can import:

If you have your address stored in multiple columns in your CSV, then click on "Provide the address using multiple fields" - here's an alternate sample spreadsheet (available as an .XLSX template or a .CSV template) with addresses formatted in this manner. You will see more address columns available for mapping to your spreadsheet:

For each of the fields, click on "Select a column" and map it to the appropriate column from your spreadsheet. You must map one column to the Delivery Address to proceed.

Once you have completed mapping. Click on Next in the top right corner.

Note: If you see an error, then your spreadsheet or .CSV file is not provided in the expected format that we have described above. If you need a fresh template, download our sample spreadsheet template (available as an .XLSX template or a .CSV template) as a starting point for creating your orders list and exporting the needed .CSV file as per above. If your CSV is storing the address fields in multiple columns, then you must ensure you have mapped every column in the process above. To note, you must ensure that you are including the following in either method: Street Number and Name, Unit Number (if applicable), City, State/Province (if applicable), Country (e.g. 123 Main Street, San Francisco, CA, 94110, United States). 

5. Review and confirm your Import

You may also review and remove certain orders from being imported at this step first by using the checkbox(es) and selecting "Remove stop" from the Actions menu that pops up:

To add imported stops directly to the map, select Import and add orders - this will add all imported entries into your Address Book and add them directly to the map for immediate use in routes:

All CSV files imported to date can be accessed from the "Import history" tab of the Orders table. Click the eye icon to the right of any import to view a list of stops that are associated with each imported CSV:

Importing Stop Items

Your imported stops may include items with an associated Quantity, Name, and Weight (per item) specified by individual columns. To import an order with multiple different types of items, just add additional rows for each additional item and leave the other columns blank. Then select the Group adjacent items across blank rows into a single delivery stop checkbox when importing to associate the adjacent item rows with the preceding stop:

Here is an example spreadsheet showing an order with multiple item rows:

When the example spreadsheet shown above is imported into EasyRoutes, customers and items will be parsed as follows:

  • Michael Gauthier: 5x Skateboard, 1x Baseball Hat, 2x Sunglasses; Total Weight: 12.7kg
  • Liam Anderson: 1x Basketball; Total Weight: 600g
  • Barry Cook: 10x Hockey Puck; Total Weight: 1.7kg
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.