> ## 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)                       |