How customer records are created by ShipStation and how to import customer records with a CSV file.
When ShipStation imports orders from your store or marketplace, it will check the customer in the order against your account's existing customer database to update the customer history. If no customer record exists, ShipStation creates a new customer record.
ShipStation will use the customer's username, id number, or email address to identify the customer, depending on what is received from the order's source. For example, ShipStation identifies eBay customers based on the eBay username, but will identify Shopify customers based on the Shopify's internal customer id number. Whichever field we use, ShipStation stores the value as Username .
ShipStation uses the order's Ship To address information in the customer record. If a new order for the same customer imports into ShipStation and is using a different address, ShipStation will update the customer record to match the new order.
Add customers with manual orders
Import customers via CSV file
If you use MailChimp, our MailChimp integration automatically creates new MailChimp email subscribers when new orders are imported.
In ShipStation, go to Settings > Integrations > Integration Partners > MailChimp to learn more.
When you create a manual order, either using the New Order button in the Orders tab or an Order CSV import, ShipStation will check the customer in the order against the existing customer database to update the customer history.
New Order Button
When using this method, the manual order must include an email address for ShipStation to link the order to an existing customer or create a new customer record.
CSV Order Import
If you're performing a CSV Order Import, you will need to map a field in your CSV file to the Buyer Username during the import process for ShipStation to link the order to an existing customer or create a new customer record.
The most common way to do this is to include both an Email Address field and a Username field. Next, enter the email address for your customer into both fields. You'll then map the Username field to the Buyer Username field during the order import process (pictured below). Then, proceed with your order import normally.
ShipStation will store the order's Ship To address information in the customer record. If a new order for the same customer is created in ShipStation with a different address, ShipStation will update the customer record to match the new order.
You can modify customer records created by the manual orders process by using the Customer CSV Import process described in the next section.
You cannot export a customer list from the Customer's tab. However, you can use the Raw Data Exports from the Insights Reports to export a list of your customer records from ShipStation.
If you need access to your entire backlog of customer records (for example, to easily create a label for a call-in order), you can import those records into ShipStation using a specially formatted CSV file. All customers created in this way will be listed under the Manual ShipStation marketplace.
You can also update existing customer records by importing the specially formatted CSV file. However, ShipStation will only update customer records created under the Manual ShipStation marketplace when using this method, not customer records created by a connected selling channel or marketplace.
The CSV import process will replace the data in ShipStation with the data from the CSV. This means if you have a blank cell in the CSV for a field that currently contains data in ShipStation, the CSV import will overwrite that data with a null value and that data will no longer be available in ShipStation.
Read our CSV Import Troubleshooting and Tips article if you encounter difficulty with your Customer CSV file.