Skip to main content
The import feature lets you load bulk data into your collections from CSV or XLSX (Excel) files. You can import data into an existing collection or create a new collection during the process.
Imports page with New Import button and empty state indicating no imports yet

Importing into an existing collection

Click the import icon in the left sidebar and then + New Import to open the wizard.
Import wizard showing step 1 with Use Existing and Create New options, collection selector, and file upload zone
The wizard has 5 steps:
1

Upload File

Make sure Use Existing is selected, choose the target collection from the dropdown, and drag your CSV or XLSX file to the upload zone (or click to select it).
Maximum file size: 500 MB. Supported formats: CSV and XLSX.
2

Review Mappings

Map each collection field to a column in the CSV file. The wizard automatically detects matches (e.g. an email field is mapped automatically). For each field you can select a Subtype (General Text, ID Number) and a Country when applicable. CSV columns you don’t map will appear in the Unused CSV columns section and will be ignored.
3

Configure Options

Optionally enable Enable duplicate detection so Databases checks for existing records and avoids duplicates during the import.
4

Preview Data

Review a preview of the first rows. You will see counters for valid rows, errors, and duplicates. Click any row to see the error details.
5

Review & Confirm

Review the final summary with the file details, target collection, column mappings, and skipped fields. Click Start Import to run the import.

Importing by creating a new collection

1

Upload File

Click + New Import, select Create New, enter the name of the new collection, and upload your CSV or XLSX file.
2

Define Fields

Databases will automatically infer field types from the file’s columns. You can adjust the types manually if needed.
3

Configure Options

Optionally enable duplicate detection.
4

Preview Data

Review the row preview and verify that the data and types are correct.
5

Review & Confirm

Review the final summary and click Start Import.

Import history

All completed imports are shown in the Imports section with their status. From here you can monitor the progress of ongoing imports and review the results of previous ones.