Skip to main content

Importable customer columns reference

The columns the Import Customers dialog can map, and how each behaves. Only Name is required. Headers auto-match when they equal a field's label; anything else can be mapped by hand or skipped.

ColumnRequiredBehavior
IDNoUpdate key. When filled, the row updates that exact customer; an unknown ID fails the row.
NameYesThe customer's name. Also a fallback match key — see how rows match.
EmailNoMatch key after ID: a filled email updates the customer holding it; an unknown email creates a new customer.
CompanyNoCompany name.
PhoneNoPhone number.
FaxNoFax number.
Address Line 1NoPart of the address block; with Name and Zip, also a match key.
Address Line 2NoSecond address line.
CityNoCity.
State / ProvinceNoFull state or province name.
State / Province CodeNoShort code (for example NC).
Zip / Postal CodeNoPostal code; part of the name-address match key.
CountryNoFull country name.
Country CodeNoISO code (for example US).
Email Opt OutNoMarketing opt-out flag.
Default Sales RepNoLooked up by name — created automatically if no rep with that name exists.
Sales Channel OriginNoLooked up by name; must already exist.

On a new customer, the row's address is saved as both the default shipping and billing address.

Last verified: