# 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

1. Go to **Customers**.
2. Click **Export**.
3. 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](https://docs.getleal.com/customers/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](https://docs.getleal.com/customers/importing-customers) the file back. Matching rows are updated, not duplicated.
- **Moving to another system** that accepts a CSV of contacts.
