> ## Documentation Index
> Fetch the complete documentation index at: https://spreecommerce.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Import File Template

> Download a product import file template for Spree Commerce open-source

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](https://raw.githubusercontent.com/spree/spree/refs/heads/main/docs/downloads/product_import_file_template.csv).

<Note>You don’t need to follow the field naming conventions in this template exactly. Field names can be mapped manually during the import process.</Note>

<Warning>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.</Warning>

| Field | Description |
| - | - |
| **sku** | A unique alphanumeric code used to identify variants |
| **name** | The name of the product |
| **slug** | Sets the URL path of the product (e.g. yourstore.com/products/slug) |
| status | The status of the product, e.g., Active, Draft, Archived |
| description | The product description |
| meta\_title | If not set, Name will be used in search engine listings |
| meta\_description | If not set, Description will be used in search engine listings |
| meta\_keywords | Can improve your website's visibility, attract more relevant traffic |
| tags | Tags that should be added to the product |
| price | The price for the product/variant to be paid by the customer |
| compare\_at\_price | The non-marked-down price of the product being sold |
| currency | The currency in which the price should be imported |
| width | Width of the product/variant |
| height | Height of the product/variant |
| depth | Depth of the product/variant |
| dimensions\_unit | The unit of measurement used for the dimensions (in, ft, cm, mm) |
| weight | Weight of the product/variant |
| weight\_unit | The unit of measurement used for weight (oz, lbs, g, kg) |
| available\_on | When the product should be made available for purchase |
| discontinue\_on | When the product should be discontinued and hidden from the storefront |
| track\_inventory | Whether or not you track inventory levels for the product (TRUE/FALSE) |
| inventory\_count | The stock quantity of the product/variant |
| inventory\_backorderable | Whether the product can be ordered when out of stock |
| tax\_category | The tax category the product should be assigned, e.g., Default, Non-taxable |
| shipping\_category | The shipping category the product should be assigned, e.g., Default, Digital |
| image1\_src | A link to the primary image product/variant image |
| image2\_src | A link to the second product/variant image |
| image3\_src | A link to the third product/variant image |
| option1\_name | The name of the 1st  [product option](https://spreecommerce.org/docs/user/manage-products/product-options) |
| option1\_value | The value of the 1st product option |
| option2\_name | The name of the 2nd product option |
| option2\_value | The value of the 2nd product option |
| option3\_name | The name of the 3rd product option |
| option3\_value | The value of the 3rd product option |
| category1 | The 1st [category](https://spreecommerce.org/docs/user/manage-products/product-taxonomies) to which the product should be assigned |
| category2 | The 2nd category to which the product should be assigned |
| category3 | The 3rd category to which the product should be assigned |
| metafield.namespace.key | The value for the product metafield [namespace.key](https://spreecommerce.org/docs/user/settings/metafields) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.