Moving from another tool? You can upload a CSV of your existing customers and we will guide you through matching the columns. Once imported, those customers can sign in, see their order history, and receive emails from your store.
What you need before you start
- A CSV file of your customers (exported from a spreadsheet or another tool)
- An email column for each customer — this is the only required field
- Optional columns the import understands: first name, last name, phone, date of birth, accepts marketing, tags, and segment
Import your list
- 1
Open Orders > Customers, then View all customers
In the sidebar, click Orders, then Customers, then click View all customers to open the directory. Click Import customers in the top right.
- 2
Download the template (optional but recommended)
On the import page, click Download template to grab a CSV with the exact columns we recognise. Paste your data into it to skip most of the column-matching work later.
- 3
Upload your CSV
Drop the file into the upload area. We read the column names so we can suggest matches in the next step.
- 4
Match the columns
We auto-match obvious columns — email, first name, last name, and phone. Tweak any that didn't match, and map the optional fields (date of birth, accepts marketing, tags, segment) by hand. Email mapping is required.
- 5
Preview the data
Look at the first few rows to make sure each column lines up with the field you expect. Email must be present for every row.
- 6
Run the import
Click Import to start. The page shows progress and tells you how many customers were added, updated, or skipped (for example because the row had no email).
Tags and segments accept multiple values
Separate multiple tags with semicolons in the same cell (for example, "vip;regular"). Segment takes a single value per row.
Existing customers are merged
If an email in your CSV already exists in your store, we update that customer with the new details instead of creating a duplicate.
Frequently asked questions
Will imported customers receive an email?
Not automatically. Imported customers are stored quietly. They start receiving order or marketing emails only when they sign in or place an order.
Can I import order history too?
Not from this tool. The import brings in customer records and contact details. Order history needs to live in your previous tool, or you can rebuild it with manual orders for the most important ones.
What happens if my CSV has bad data?
Rows missing an email are skipped, and we tell you exactly how many. You can fix those rows and re-upload — duplicates are updated, not added.