Skip to main content
Below is a list of all the product fields that can be imported via CSV (required fields in bold). For an example of how to structure multi-variant products, please download this product import file template.
You don’t need to follow the field naming conventions in this template exactly. Field names can be mapped manually during the import process.
The slug field acts as the unique identifier for the product in Spree - no two products can share the same slug. When updating products via CSV import, the slug must exactly match an existing record to avoid creating duplicates.
FieldDescription
skuA unique alphanumeric code used to identify variants
nameThe name of the product
slugSets the URL path of the product (e.g. yourstore.com/products/slug)
statusThe status of the product, e.g., Active, Draft, Archived
descriptionThe product description
meta_titleIf not set, Name will be used in search engine listings
meta_descriptionIf not set, Description will be used in search engine listings
meta_keywordsCan improve your website’s visibility, attract more relevant traffic
tagsTags that should be added to the product
priceThe price for the product/variant to be paid by the customer
compare_at_priceThe non-marked-down price of the product being sold
currencyThe currency in which the price should be imported
widthWidth of the product/variant
heightHeight of the product/variant
depthDepth of the product/variant
dimensions_unitThe unit of measurement used for the dimensions (in, ft, cm, mm)
weightWeight of the product/variant
weight_unitThe unit of measurement used for weight (oz, lbs, g, kg)
available_onWhen the product should be made available for purchase
discontinue_onWhen the product should be discontinued and hidden from the storefront
track_inventoryWhether or not you track inventory levels for the product (TRUE/FALSE)
inventory_countThe stock quantity of the product/variant
inventory_backorderableWhether the product can be ordered when out of stock
tax_categoryThe tax category the product should be assigned, e.g., Default, Non-taxable
shipping_categoryThe shipping category the product should be assigned, e.g., Default, Digital
image1_srcA link to the primary image product/variant image
image2_srcA link to the second product/variant image
image3_srcA link to the third product/variant image
option1_nameThe name of the 1st product option
option1_valueThe value of the 1st product option
option2_nameThe name of the 2nd product option
option2_valueThe value of the 2nd product option
option3_nameThe name of the 3rd product option
option3_valueThe value of the 3rd product option
category1The 1st category to which the product should be assigned
category2The 2nd category to which the product should be assigned
category3The 3rd category to which the product should be assigned
metafield.namespace.keyThe value for the product metafield namespace.key