Bulk Import

Bulk Import lets you add hundreds of products at once using a CSV spreadsheet or a ZIP file of product images. Once uploaded, the system processes each product in the background — you can close the browser and come back later. A progress indicator shows you exactly how many products have been processed.

stepByStep

Go to Bulk Import

In the sidebar, tap Bulk or go to Upload → Bulk. The Bulk Import screen shows your import history and a prominent "Start Bulk Import" button.

Add screenshot — bulk-entry

Download the CSV template

Tap "Download Template" to get the official CSV file. Open it in Excel, Google Sheets, or any spreadsheet app. The template includes all supported columns with example values and instructions in row 2.

Add screenshot — bulk-template

Fill in your product data

Fill each row with one product. Required columns are: name, price, currency. Optional but recommended: sku, brand, category, sub_category, color, material, description, image_url (public URL or leave blank for image ZIP). The template supports 30+ columns — see the column guide in row 2. Any column not in the standard set is stored as a custom attribute in rawProductData. Do not change column headers.

Add screenshot — bulk-csv-fill

Prepare a ZIP with images (optional)

If you have product images to attach, put all image files (JPG/PNG/WebP) in a folder and compress it to a .zip file. Name each image to match the SKU in your CSV (e.g. SKU001.jpg). Images that do not match a SKU are ignored.

Add screenshot — bulk-zip-images

Upload your CSV (and ZIP)

Tap "Upload CSV" and select your filled-in template file. If you have a matching image ZIP, tap "Upload Images ZIP" next. Both files must be uploaded before you tap Start.

Add screenshot — bulk-upload-files

Start the import job

Tap "Start Import". The system validates your CSV for formatting errors. If there are issues, it shows a list of rows to fix. If validation passes, the import job starts and you see a progress bar.

Add screenshot — bulk-start-job

Monitor progress in the Bulk Workspace

The Bulk Workspace table shows each product row with a status dot: grey (queued), blue (processing), green (done), red (error). Each product is enriched individually — some finish faster than others.

Add screenshot — bulk-workspace

Handle errors

Products with a red dot have an error. Tap the row to see the specific error message (e.g. "Image not found", "Price must be a number"). Fix the issue and tap "Retry" on that item, or fix your CSV and re-import the failed rows.

Add screenshot — bulk-errors

proTips

•Do a test import with 5–10 rows first. Once the format is right, import the full catalog.

•The image_url column accepts any publicly accessible URL. If the URL cannot be fetched, the product is created without an image and you can add one later.

•Keep SKUs short and unique — they are used to match products during re-import (upsert by SKU). Products without a SKU always create new rows.

•Re-importing the same CSV updates existing products matched by SKU and creates new ones for SKUs not yet in the catalog. This makes bulk CSV the fastest way to update prices or stock for hundreds of products at once.

•Add any non-standard columns (e.g. "Fabric GSM", "Finish Type") directly to the CSV. They are stored in rawProductData and appear in AI enrichment prompts and exports.

•The background job continues even if you close the browser. Come back to the Bulk page later to check progress.

frequentlyAskedQuestions

allHelpTopics

stillNeedHelp contactSupport