Skip to content

Import and export customers (CSV)

Have a customer list in Excel, Google Sheets or an old system? Save it as a CSV file and import it into Tellfox in one go. You can export the whole list back as a CSV at any time.

  1. Open Customers and tap Import.

  2. Choose your file under CSV file and tap Check the file.

  3. Read the check: how many are New, how many Match a customer you have and are added to them, how many Repeat an earlier row of the file, and Rows skipped, each with its reason, like “Row 12: phone is not valid”. Below, The first 20 rows shows what each row will become.

  4. If it looks right, tap Import N customers. The page shows the result, like “Import finished: 240 new, 12 added to existing customers, 3 skipped.”

If an import stops part way, just import again: customers already imported are not doubled.

  • A UTF-8 CSV file (in Excel, choose “CSV UTF-8”), up to 10,000 rows and 2 MB.
  • The first row holds the column names, in English or Thai. A name column is required; the others are optional.
Data Column names Format
Name name, full name, customer, ชื่อ, ชื่อลูกค้า Required, up to 80 characters
Phone phone, tel, mobile, telephone, เบอร์, เบอร์โทร, โทร, โทรศัพท์ Several numbers separated by ;: the first is used
Email email, e-mail, อีเมล Several separated by ;: the first is used
Tags tags, tag, แท็ก Separated by ;, like VIP;Regular
Note note, notes, โน้ต, หมายเหตุ Becomes a note on the customer page
Birthday birthday, birthdate, วันเกิด YYYY-MM-DD, like 1990-04-25
Language language, lang, ภาษา en, english, อังกฤษ, th, thai or ไทย (any capitals)

A row whose email or phone matches a customer you already have is added to that customer instead of making a new one: a phone, an email, tags, a note, and the birthday if they have none. An import never changes a customer’s name, or anything the customer verified themselves.

The owner taps Export on the Customers page to download a CSV of every customer. Its columns are name, phone, email, on LINE, language, birthday, tags, created, last visit, visits, spent (THB), offers: LINE and offers: email.

  • The file holds no LINE IDs.
  • A cell that starts with =, +, - or @ gets a ' in front, so Excel doesn’t run it as a formula. Tellfox’s import takes it off again, so an exported file imports back.
  • One file holds up to 50,000 customers.
  • Every export is recorded on the Activity page.