Skip to main content

CSV Uploads

You can upload CSV files directly in Mitzu to create a new data table that can be used in analysis.

Uploading a file​

Open the project's CSV upload widget and pick a file from the file chooser — the file is ingested as soon as it is selected and shown in the list as Pending save. Repeat for additional files, then click Save to commit them to the project. Pending uploads can be removed with the trash icon before saving.

Supported column types​

Mitzu automatically detects and maps common scalar types from CSV values.

  • Int - whole numbers, for example 1, 42, 9000
  • Float - decimal numbers, for example 10.2, 0.75
  • Date - calendar dates, for example 2024-01-01
  • Timestamp - date and time values, for example 2024-01-01 10:15:01
  • String - text values

If a value is empty, Mitzu keeps it as null.

CSV upload limits and behavior​

  • Maximum file size: 20 MB per upload
  • File must be in valid CSV format
  • Uploads are processed in chunks for reliability on larger files
  • Column names are normalized to safe names (for example, spaces become underscores)

Important limitations​

  • Only CSV input is supported in this flow
  • Complex nested data structures are not inferred from CSV values
  • Type detection is based on the values present in the uploaded file
  • Mixed formats in a single column may be interpreted as text

Tips for best results​

  • Include a header row with clear column names
  • Keep each column semantically consistent (for example, do not mix numbers and free text)
  • Use ISO-like date and timestamp formats where possible