Skip to main content

Free forever plan · 3,663 reachable storefronts · No credit card to start

Customers & Marketing

Import customers from CSV

Map email, phone, consent, and optional loyalty columns to safely upsert customer records.

Updated

On this page
Plan availability: Pro. Customer Import requires Pro. SMS consent import additionally requires SMS access and merchant attestation. The active production feature matrix is authoritative if an administrator changes an entitlement.

Start the import

  1. In the dashboard, open Shop → Customers, choose Import CSV, and upload the file.
  2. Map at least one identity column: email or phone.
  3. Choose whether to Skip duplicates.
  4. Preview the rows and start the chunked import.

To import text consent, enable Text opt-in for imported phone numbers and attest that the numbers already consented to texts from the business. If the CSV has a per-row status, map Row-level text status column values to Opted in, Opted out, or Ignore.

What the importer preserves

  • Existing unsubscribe state is preserved.
  • When Skip duplicates is off, an existing matching contact can have missing or placeholder contact fields filled without overwriting meaningful contact data. The linked customer-directory name is a separate field: it changes only when the importer matches that customer by email or phone and its current first name qualifies as a fallback. Reimporting is not a reliable bulk repair for existing names displayed as “Customer.”
  • Conflicting email and phone matches are skipped.
  • Mapped loyalty points seed only a customer with no existing balance or history.

Common problems

  • Importing a phone list without consent attestation must not enable SMS.
  • With Skip duplicates on, matching contacts are skipped. If imported names still display as “Customer,” contact Cottage CMS support for a review instead of inventing email addresses or creating duplicate customer records.
  • Reimporting the same loyalty points does not add them a second time.
  • Large imports are chunked; keep the progress panel open until completion.

Next steps


Keywords

CSV import, customer import, contact import, duplicate customers, SMS opt-in, consent column, loyalty points

Was this article helpful?