# How do I import a CSV or Excel file?

> Click Import above a table's records: the wizard reads CSV, Excel or JSON, maps each column, and can update matching records instead of adding duplicates.

Source: https://tadabase.com/docs/faq/how-do-i-import-a-csv-or-excel-file  
Status: Verified Nov 22, 2026. Checked against the current product

Click **Import** above the table's records. The wizard reads a CSV, Excel or JSON file, lets you map each column to a field, and updates matching records instead of adding duplicates when you match on a unique field such as an email or ID. It runs in the background, a notice on the table shows the result, and an import you repeat can be saved as an import template.

To update instead of duplicate, choose **Update records that already exist** on the **Advanced Import Options** step and pick the **Imported Column** and **Tadabase Field** that must match. Full steps: [Import records from a CSV file](https://tadabase.com/docs/data/importing-from-the-builder) and [Save an import as an import template](https://tadabase.com/docs/data/import-templates).

## Large files and imports that seem stuck

- The upload step shows the largest file the wizard accepts. If your file is bigger, split it into several files and import them one after another.
- You can close the wizard while an import runs. To see how it is going, open the wizard again and click **Previous imports**: each run shows its **Status** and its **Added**, **Updated**, **Skipped** and **Failed** counts.
- When rows fail, the notice on the table offers **Why did these rows fail?**, **Download the failed rows** and **Import the N row(s) that failed**.
- If a run shows no progress for a long time, contact support with the table name and when you started it.

## Stop the email after every import

When an import finishes, the app owner gets an email with the result and any rows that did not go in. There are two switches:

- For one app: in **Settings** > **General**, under **Notifications**, set **Import Completion Emails** to **Only when records fail** or **Off**. An import that stops before it can read its file is still reported unless this is **Off**.
- For all your apps: open **Edit Profile** from your account menu and turn off **Send Import Finished Emails**.
