Adding products one at a time can be very time consuming, especially if you have hundreds or even thousands of products to upload.

You can save a lot of that time by making use of the product import feature which allows you to upload products in bulk from a CSV or Excel file.

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.

To import a product file, navigate to the Products tab of the admin dashboard and locate the ‘Import’ button in the top right corner.

Clicking on ‘Import’ will open up a window to begin the process of importing a product file.

You’ll be greeted by two options:

  1. Upload file - choose an existing file to automatically import to your store

  2. Manually enter data - create a file by entering all the necessary product data manually

First, lets take a look at uploading a file

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.

This will automatically extract the product data from the file.

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.

Hovering over the rows with the cursor will show a preview of the incoming data.

In the ‘Destination Fields’ column, you can select the internal field that the incoming field should be mapped to.

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

Once you’re happy with the mapping of the fields, click ‘Continue’ in the top right corner of the window.

Review and Submit

On the next screen, can review the data to be uploaded and submit it for upload provided there are no errors.

In the above example, there are some errors - two rows have a matching SKU.

To fix this error, you can simply click on one of the fields and edit the data and click Enter.

You can edit all of the other data fields in the file, error or not, in the same manner.

Once you’ve fixed all the errors and updated any other fields you want to change, click Submit Data in the top right corner of the window.

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.

When the import is complete, the status of the import at the top of the page will be marked as ‘Processed’.

The products will now manageable in the Products tab of the admin dashboard.

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.

Once you’ve added all the relevant product data, click ‘Submit data’ in the top right corner of the window and the products will be imported.

Import Auditing

You can audit past imports by navigating to Settings > Audit Trail and clicking on ‘Imports’ at the top of the page.