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
- In the dashboard, open Shop → Customers, choose Import CSV, and upload the file.
- Map at least one identity column: email or phone.
- Choose whether to Skip duplicates.
- Preview the rows and start the chunked import.
Handle consent carefully
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