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

🧪 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

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.