Back to Docs

Importing Data with CSV

Bulk-create entities from spreadsheets with mapping and preview.

Supported file formats

  • CSV (recommended)
  • XLSX (first sheet)
  • JSON array of objects

Import flow

  1. Open a collection and click Import.
  2. Upload your file.
  3. Map each column to an existing or new field.
  4. Preview rows before confirming.
  5. Run import and review the result log.
CSV import mapping interface
Map columns carefully, then validate a preview before running a full import.

Best practices

  • Keep header names clear and consistent.
  • Test with a small sample before full import.
  • Use one row per entity.

Common issues

  • Missing required fields (for example Name)
  • Invalid value types for number/date fields
  • Unexpected blank rows in source file