Skip to content

Importing products

Load a CSV or spreadsheet into a schema with automatic header mapping, a validation report and resumable ingestion at any size.

The Imports tab walks a CSV or XLSX file through a wizard built to handle a few rows or a million with the same flow.

  1. Upload: the file streams to storage. Kabaido sniffs the delimiter, encoding and header row and shows the size.
  2. Map: headers are mapped to schema fields automatically using field synonyms and fuzzy matching. Unmapped columns are parked as extra attributes or ignored. You can save a mapping to reuse next time.
  3. Validate: the first 500 rows are parsed server side into a report showing type coercion, unit hints (for example 3/8 in normalised to 9.525 mm) and a duplicate sku policy of update or skip.
  4. Run: ingestion happens in batches with a live progress view.
  5. Embeddings: a backfill job runs so products are searchable lexically straight away and semantically as the backfill completes.

Large files

Ingestion runs server side in upserts of 1000 rows and tracks a cursor per batch, so if a run is interrupted it resumes from where it stopped rather than starting again. Files over 200000 rows take a faster bulk load path. You can cancel a run and it stops cleanly at the next batch boundary.

Rows that fail validation are written to an error report in storage with the row number and the reason, so a partial import never silently drops data.

Imports are checked against your plan product limit on every insert. If a file would take you over the limit the run is blocked and you are prompted to upgrade.