Skip to main content

File Upload Requirements

Supported file formats and size limits for importing data into Shopify with Altera

Updated this week

File Formats

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 CSV Files

  • ZIP Archives of Multiple CSV Files

The file size limit for any upload is 250 MB.

Excel Workbooks ( .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.

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.

  • CSV Delimiters: We recommend using the comma (,) delimiter for best compatibility. However, we also support other standard delimiters including:

  • Tab (\t)

  • Semicolon (;)

  • Space ()

  • Colon (:)

  • Pipe (|)

  • The app will automatically detect which delimiter your CSV file uses.

ZIP Archive of CSV Files ( .zip)

  • Combine multiple CSVs into one compressed file.

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

Changing Data Type Mapping

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

250 MB per upload

Need to upload more than 250 MB? Contact us, or 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?