Skip to main content

File upload requirements

Updated over a week ago

Altera accepts uploads in Matrixify‑formatted files so you can migrate or bulk update store data with zero reformatting. We currently support three container formats - Excel workbooks, single CSVs, and ZIP archives of multiple CSVs - each up to 50 MB per upload.

1. Excel workbook ( .xlsx)

  • One or more worksheets can be included in the same workbook.

  • Sheet names drive the import- e.g. a sheet named Products triggers a product import, Customers triggers a customer import, and so on.

2. Single CSV file ( .csv)

  • Use when importing one data entity at a time.

  • Here, the file name (before the extension) determines the import typeproducts.csv, orders.csv, collections.csv, etc.

3. ZIP archive of CSVs ( .zip)

  • Combine multiple CSVs into one compressed file.

  • Each CSV inside the ZIP is treated independently; its file name sets the import type.

Need a different mapping? You can change it after upload

If your sheet or file names don’t match the object types (products, customers etc..), no worries. After the upload completes, you can manually assign each sheet or CSV to the correct data type before starting the import.

File size limit

Format

Maximum size

.xlsx, .csv, .zip

50 MB per upload

Need to upload more than 50 MB? Split your data into several files or compress multiple CSVs into separate ZIPs, each under the limit.

Field reference

For a complete list of accepted columns for every type of data, see our field reference.

Import tips

  • Keep the first row as headers exactly as in the reference.

  • Remove empty columns, hidden formulas, and unused sheets before saving.

  • Save CSVs with UTF‑8 encoding.

  • Preview data in Altera before clicking Start import to catch header or encoding issues.

Did this answer your question?