# Upload product data in bulk

#### **Upload Product Data in Bulk**

Canoa supports bulk catalog uploads using CSV files, allowing you to publish up to **100,000 product records** in a single file. This method is ideal for brands managing their data in spreadsheets or exporting from a PIM, e-commerce platform, or ERP system.

Whether you're launching your entire catalog or just testing a handful of SKUs, this guide walks you through the process.

***

**🧰 What You’ll Need Before Uploading**

* A CSV file containing all required product fields
* UTF-8 encoding and `.csv` file format
* Live links for images, PDFs, and backlinks
* A brand admin account on [canoa.supply/brands](https://www.canoa.supply/brands)

> 🧪 First time uploading? Start with 5–10 rows to confirm formatting before uploading your full file.

***

**📥 Step-by-Step: Uploading Your CSV**

1. **Log into your Brand Dashboard**\
   → [canoa.supply/brands](https://www.canoa.supply/brands)
2. **Go to the “Catalog” tab**
3. **Click “Upload CSV”**
   * Select your `.csv` file
   * Canoa will automatically detect your column headers
4. **Review the field mapping**
   * Confirm that each column (e.g., `product_name`, `sku`, `product_url`) maps to the correct field
   * You can adjust mappings manually if needed
5. **Click “Submit”**
   * Your catalog will begin processing
   * You’ll be notified once it’s complete or if errors are detected

> ⏳ Uploads may take up to 24 hours to fully process and propagate across the platform. You can continue working while they process.

***

**✅ Best Practices for Clean Uploads**

* **Use direct image URLs** — e.g., `https://cdn.yourbrand.com/images/chair.png`
* **Avoid formatting artifacts** — No merged cells, blank headers, or trailing spaces
* **Include tracking in your backlinks** — Use UTM tags like `utm_source=canoa`
* **Keep SKUs unique** — Duplicate SKUs will cause overwrite or conflict
* **Ensure file is UTF-8 encoded** — Especially if working in Excel, which may default to other formats

***

**🚧 Troubleshooting Common Issues**

| Issue                | Likely Cause                                | Solution                               |
| -------------------- | ------------------------------------------- | -------------------------------------- |
| Upload fails         | Missing required columns or encoding issues | Check field headers and CSV format     |
| Images don’t display | Invalid or restricted image URL             | Use public, direct JPG/PNG links       |
| Duplicate entries    | Matching SKUs used across multiple rows     | Deduplicate or combine variant options |
| Data not updating    | Upload didn’t overwrite previous values     | Make sure SKU matches and resubmit CSV |

***

**🧠 Pro Tip: Split Large Catalogs**

If you’re managing more than 100,000 SKUs or want to break uploads by category or geography, simply split your catalog into multiple CSV files and upload them sequentially.