Importing and Exporting Customers
A customer import or export involves having all of your customer information in a CSV file, which can be edited as a spreadsheet. Whether you're moving customers to a particular customer group or adding store credit, exporting and importing customer data is the fastest way to update existing customer information or add new customers in bulk.
The following fields are required when adding or updating your customers.
- Email Address — no two can be the same. A customer’s account can only be assigned to one at a time.
- First Name — customer's first name
- Last Name — customer’s last name
Did you know? Abbreviations will cause an address failure at checkout. If entering a customer’s address information, the state or province must be spelled out, not abbreviated. (For example, use California, not CA.)
Exporting Your Customers
1. Go to Customers › Export.
2. Select your export settings.
- Template — We recommend Bulk Edit or a custom export template.
- File Format — You can export your file as a CSV (recommended) or XML. You can only re-import CSV files, not XML or any other file type.
- Save export to the server for later download? — Select this option to save the file to your exports folder in WebDAV (recommended for exporting 1000+ customers).
3. Click Continue, then click Export my customers to a CSV file.
4. When the file is ready for download, click the download link.
Choosing an Export Template
An export template determines specifically what customer information you're exporting. All export templates will include details like the customer's name and email address, but you can get more granular about other details. For a full list of exportable information, see the table of Exportable Fields.
BigCommerce comes with a few customer export templates built in:
- Bulk Edit (recommended) — The bulk edit template was made for updating your customer information. It includes the majority of exportable fields, and has specifically named columns that let you skip steps in the importing process.
- Default — The default template includes only basic product details such as name, weight, description and price.
You can also create your own custom export template and select which of the exportable fields you want it to include.
Creating a Custom Export Template
Customizing your template is the best way to ensure your customer export has exactly what you want. You can build an export template from scratch or customize a copy of one to suit your needs.
We recommend using a copy of the Bulk Edit template and modifying it for your needs. This will let you bypass the settings and field mapping when you go to re-import it later.
To start, go to Advanced Settings › Export Templates. Use the Action menu to Create a Copy of the Bulk Edit template.
Type a name for your template in the Template Details section and since this template will be for customers, ensure Enable Customers Exporting? is the only option selected under Export Options. Notice that the tabs listed along the top update with your selections.
Customize the rest of the template settings to fit your needs. When you're ready, click the Customers tab at the top to view the available export fields.
Go through and check or uncheck each field as needed. Click Save & Exit when you have made your changes. You can now export your data using your new template.
Importing Your Customers
The steps below will guide you through importing your customers into BigCommerce.
Before beginning, make sure that you have a backup (an unedited Bulk Edit export) of your customers so that you can put things back to how they were should things go awry.
1. Go to Customers › Import.
2. If you exported your file using the Bulk Edit template, check Bulk Edit Re-import, which selects the recommended settings and automatically configures the Match Import Fields step.
Did you know? If you do not use the Bulk Edit template column names, you will need to match your CSV's columns to their corresponding fields.
3. Under the File Details section next to Import File, upload your CSV file directly from your computer by browsing to it.
Attempting to upload too large a file can cause the import to fail. If your file is larger than 512 MB, try breaking it up into smaller files.
4. You can typically leave the additional File Details settings alone. They are used if you are uploading a non-spreadsheet CSV and need to specify the import settings.
- Use a file already on the server — If you have a larger file or a slow internet connection, you can connect to WebDAV and save your file to the import_files folder, then select this option. Files can be up to 512 MB.
- Contains Headers? — Does the file contain column headings?
- Field Separator — In non-spreadsheet CSVs, what punctuation is used to separate the fields?
- Field Enclosure — In non-spreadsheet CSVs, what punctuation is used to tie phrases together (e.g. "Socks and Shoes")?
5. Click Next when done.
6. Click Next when done.
7. Click Start Import when ready to begin importing your products.
When the import is complete, you will see an import summary.
If there was an issue when importing, click More Information to see any errors generated during the import.
Be careful! If a customer is imported without a password, they will need to go through the password reset process.
Matching Import Fields
Next, to Match (field), select your CSV's corresponding column name from the drop-down. You do not need to match every column, but you must match the required columns.
Below is a table of all customer attributes that are exportable via a CSV. The majority of these fields are included when using the Bulk Edit export template. See Custom Export Template Fields for a list of fields that do not appear in the Bulk Edit template but can be added to a custom export template.
|Email Address||The customer's email email@example.com|
|First Name||The customer's first name||John|
|Last Name||The customer's last name||Smith|
|Company||The company, if the customer orders on behalf of a business||Acme, Inc.|
|Phone||Customer's phone number||555-555-5555|
|Notes||Your notes about the customer||Customer is tax-exempt|
|Store Credit||Use this to apply store credit for the customer to use when shopping. (This will allow the customer to pay with store credit.)||50 (uses your default currency; e.g. 50 = $50 if you are using USD)|
|Customer Group||Assigned customer group if using the Customer Group feature||Retail|
|Addresses||Contains the following fields:|
|Address ID||The unique system-created ID for the address||Number|
|Address First Name||The first name associated with a particular address||Sarah Jane|
|Address Last Name||The last name associated with a particular address||Smith|
|Address Company||The company associated with a particular address||Acme, Inc.|
|Address Line 1||The first line with an address; normally contains street and house/housing complex number||123 Main St|
|Address Line 2||The second line with an address; normally contains care of information and unit or building number||Apartment 201|
|City/Suburb||The address' city or suburb||Austin|
|State/Province||The address' state or province||Texas|
|Zip/Postcode||The address zip or postal code||78726|
|Country||The address country||United States|
|Address Phone||The phone number associated with that address||555-555-5555|
|Address Form Fields||If you created address form fields, your customers' responses will be included here||Question: Where did you hear about us? Response: Online ad|
|Form Fields||If you created form fields, your customers' responses will be included here||Question: Where did you hear about us? Response: Online ad|
|Receive ACS/Review emails||Records whether the client opted in or out of receiving product review requests or abandoned cart saver emails||1 = Yes, 0 = No|
Manually Added Fields
These fields are not exported in the Bulk Edit export template by default but can be added to a custom export template.
|Customer ID||The system-created unique ID for the customer||Number|
|Customer Name||The customer's first and last name||John Smith|
|Date Joined||The date the customer account was created||10/15/2017|
|Address: Address Name||The full name associated with a particular address, can be different from the customer placing the order||Sarah Jane Smith|
|Address: State Abbreviation||The abbreviated form of the address' state or province||TX|
|Address: Building Type||The address building type (commercial or residential). Used for shipping purposes.||Residential or Commercial|
|Orders||The number of orders the customer has placed (exportable only)||2|
|Tax Exempt Category||Only used if you have linked your paid Avalara account.||See tax-exempt category code|
You can add additional addresses by changing the 1 in the column (e.g. Address First Name - 1) to 2 or more. All addresses will appear in the customer's address book, but there is no distinction between billing or shipping addresses