Importing Products via CSV
Add hundreds of products at once using CSV import.
Download Template
- Go to **Products**
- Click **Import**
- Download the CSV template
- Open in spreadsheet software
CSV Format
Required Columns - **Handle**: URL-friendly identifier - **Title**: Product name - **Body (HTML)**: Description - **Price**: Selling price
Optional Columns - **Variant SKU**: Unique identifier - **Variant Price**: Variant-specific price - **Variant Inventory Qty**: Stock count - **Image Src**: Image URL - **Tags**: Comma-separated tags
Preparing Your Data
Basic Product ``` Handle,Title,Body (HTML),Price,Image Src blue-shirt,Blue Casual Shirt,<p>Comfortable cotton shirt</p>,29.99,https://example.com/shirt.jpg ```
Product with Variants ``` Handle,Title,Option1 Name,Option1 Value,Variant Price,Variant SKU blue-shirt,Blue Casual Shirt,Size,Small,29.99,BLU-S blue-shirt,,Size,Medium,29.99,BLU-M blue-shirt,,Size,Large,31.99,BLU-L ```
Importing
- Prepare your CSV file
- Go to **Products > Import**
- Upload your file
- Map columns (if needed)
- Click **Import**
- Review results
Import Tips
- **Test first**: Import 5-10 products initially
- **Images**: Use publicly accessible URLs
- **Encoding**: Save as UTF-8
- **Validation**: Check for errors before importing
- **Backup**: Export existing products first
Common Errors
| Error | Solution |
|---|---|
| Duplicate handle | Make handles unique |
| Invalid price | Use numbers only, no currency symbol |
| Missing required field | Check all required columns |
| Image not found | Verify URL is accessible |
After Import
- Review imported products
- Check variant configurations
- Verify images loaded
- Test on storefront