It’s strongly recommended that you pre-format your product file so that the columns match the internal values in Spree. To learn more about formatting your product files, please refer to a separate support article.


- Upload file - choose an existing file to automatically import to your store
- Manually enter data - create a file by entering all the necessary product data manually
Upload File
When clicking on ‘Upload file’, you’ll be prompted to select a file from your device. Select the file you want to upload and click Open.
Map Fields
Next, you’ll be directed to the field mapping step, which allows you to match the incoming fields from the CSV with the internal fields in your store.

If you preformatted your CSV file to match the internal naming conventions, most if not all of these fields will be automatically matched.

Review and Submit
On the next screen, can review the data to be uploaded and submit it for upload provided there are no errors.
You can edit all of the other data fields in the file, error or not, in the same manner.


Import Processing
Once you’ve submitted the data, you’ll be redirected to another page where you can watch the monitor the progress of the import process.


Manually Enter Data
If you don’t have an existing file to upload, you can manually enter the product data directly into the product importer, which you may find more convenient than adding products one by one using the product editor. Simply fill in all of the necessary fields following the Product File Format guidelines.
Import Auditing
You can audit past imports by navigating to Settings > Audit Trail and clicking on ‘Imports’ at the top of the page.