Exporting customers
Download every customer in your store as a CSV file, see what's in it, and how long the download link lasts.
You can download your whole customer list as a CSV file at any time, on any plan. Leal builds the file in the background and emails you a download link. The file uses the same columns as the importer, so you can edit it in a spreadsheet and import it straight back.
Export your customers#
- Go to Customers.
- Click Export.
- Confirm the message "Export every customer in this store to a CSV? We'll email you a download link when it's ready."
You'll see "Export started. We'll email you a download link when it's ready." The email goes to the team member who clicked Export.
If your store has no customers yet, the button is greyed out with the hint Add a customer before exporting.
What's in the file#
The file is named after your store and the date, for example bean-there-customers-2026-11-06.csv. It has one row per customer and these columns:
| Column | What it holds |
|---|---|
first_name |
First name. |
last_name |
Last name. |
email |
Email address. |
phone |
Phone number in international format. |
birthday |
Birthday as YYYY-MM-DD. |
source |
The system this customer is linked to, such as square, if any. |
external_id |
Their ID in that system, if any. |
If a customer is linked to more than one outside system, the file includes the oldest link only, because the importer reads one pair per row.
The export always includes every customer in the store. It ignores anything typed in the search box.
What isn't in the file#
The export is a contact list. It doesn't include stamp counts, cards, stamp history, redemptions, or whether a customer has unsubscribed from campaigns. Those stay in Leal, on each customer profile.
The email and download link#
The email "Your customer export is ready" tells you how many customers are in the file and has a Download CSV button.
The link works for 7 days. After that it stops working and the file is deleted. You can run a new export from the Customers page whenever you need one.
If something goes wrong, you'll get a "Customer export failed" email instead. Try the export again from the Customers page.
Keeping exports safe#
An export is a file full of personal details. Treat it with care:
- Don't forward the email. Anyone with the link can download the file until it expires.
- Delete downloaded copies from your computer when you're done with them.
- Only share the file with people who need it, and only for the reason your customers gave you their details.
Common uses#
- A backup of your customer list.
- Bulk edits. Export, correct names or birthdays in a spreadsheet, then import the file back. Matching rows are updated, not duplicated.
- Moving to another system that accepts a CSV of contacts.
Still stuck?
Our team answers every message. Contact support