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

# Import Products to Eaglecart from a CSV File

> Import your products, variants and images into Eaglecart from a CSV file. Download the sample CSV, upload your file, check the preview and map your columns.

[Help Center](https://help.eaglecart.com/introduction.md)

[Getting started](https://help.eaglecart.com/get-started.md)

Import your products

# Import your products

Have lots of products to add? Import them all at once from a CSV file instead of adding them one by one.

Go to **Products → Products** and click **Import**.

## 1. Prepare your CSV file

In the **Import Products** dialog, click **Download Sample CSV** to see the expected file format. You can also select **Help → How importing works** to learn how products, variants and images are organized.

You can follow the sample format or prepare your own compatible CSV. A few things to know:

* Save your file as a **CSV** (UTF-8, comma separated). Excel and text files won't work.
* Each file can be up to **10 MB** and **10,000 rows**. Split bigger catalogues into several files.
* Rows with the same **URL handle** become one product. The first row holds the product details, and each extra row adds a variant or image.
* A product can have up to **three options**, such as Color, Size and Material. **One row is one variant**, so give every combination its own row.
* Image links must open the image directly, without needing a login.

## 2. Upload your file

1. Drag your file into the upload box, or click **browse** to choose it.
2. Choose your **Product Visibility**:
   * **Publish to all sale channels:** the products appear everywhere you sell.
   * **Publish to online store only:** the products appear only on your online store.
3. Click **Upload**.

> [!WARNING]
>
> **Overwrite products with matching handles** replaces the details of products you already have with the values in your file. Leave it unticked unless you're sure you want to update existing products.

## 3. Check the preview

Before importing, Eaglecart shows how many products, variants and images it found in your CSV file. You'll also see the first product's details and variants, so you can check whether everything looks the way you expected.

If everything looks right, click **Continue to Mapping**.

## 4. Check your column mapping

Columns with matching names are mapped automatically. Under **Your column heading**, you can change which column fills each Eaglecart field. **Product name** is the only required field.

Map each Eaglecart field to a different column. Don't use the same column for two fields.

When everything looks right, click the import button, for example **Import 6 products**.

## 5. Check your products

Once you start the import, Eaglecart shows its progress at the top of the page, including how many products have been imported and the progress of their images.

Product details are imported first, followed by images. You can follow the progress directly in Eaglecart.

When the import is complete, go to **Products → Products** and check a few products to make sure their prices, variants, stock and images are correct.

## Keep reading

* **Next:** [Import your customers](https://help.eaglecart.com/get-started/import-your-customers.md): bring your customer list across.
* [Add your first product](https://help.eaglecart.com/get-started/add-your-first-product.md): add a single product by hand.
* [Migration overview](https://help.eaglecart.com/get-started/migration-overview.md): how the move to Eaglecart works.


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