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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.canoa.supply/docs/for-brands/upload-product-data-in-bulk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.