File upload requirements
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.
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.
Use when importing one data entity at a time.
Here, the file name (before the extension) determines the import type—`products.csv`, orders.csv, collections.csv, etc.
Combine multiple CSVs into one compressed file.
Each CSV inside the ZIP is treated independently; its file name sets the import type.
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.
Need to upload more than 50 MB? Split your data into several files or compress multiple CSVs into separate ZIPs, each under the limit.
For a complete list of accepted columns for every type of data, see our field reference.
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.
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 type—`products.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.
Updated on: 22/04/2025