CSV Import Integration

When to Use

CSV import is ideal when:

Your products aren't on a live website yet
You want full manual control over product data
Your site can't be scraped or doesn't have a feed
You're managing a custom catalog

Required Format

Download the CSV template from the import page. The template includes all supported columns.

Required Columns

Column	Notes
`title`	Product name
`description`	Product description (minimum 10 characters)
`product_url`	Canonical product link

Recommended Column

Column	Notes
`image`	Product image URL. Makes product cards look better in chat

Optional Columns (enrich AI context)

These optional columns give the AI more context about your products, leading to better recommendations:

Column	Notes
`price`	Price value (numeric)
`sale_price`	Discounted/promotional price (numeric)
`currency`	Currency code (e.g. `RON`, `EUR`, `USD`)
`stock_status`	`in_stock`, `out_of_stock`, or `unknown`
`manufacturer`	Brand name (auto-creates manufacturers for Owner Bias)
`product_type`	Category or type (e.g. "Supplements > Vitamins")
`gender`	Target gender (`male`, `female`, `unisex`)
`age_group`	Target age group (`adult`, `kids`, `infant`)
`condition`	Product condition (`new`, `used`, `refurbished`)
`sku`	Stock keeping unit identifier

Note: All optional columns are saved and passed to the AI as product attributes. The more data you provide, the smarter the recommendations become.

Sample Data

title	description	product_url	image	price	sale_price	currency	stock_status	manufacturer	product_type	gender	age_group	condition	sku
Vitamin C Complex	High-potency vitamin C with citrus bioflavonoids for immune support (500mg, 60 capsules)	https://example.com/products/vitamin-c	https://example.com/images/vitamin-c.jpg	49.99	39.99	RON	in_stock	NatureFirst	Supplements > Vitamins	unisex	adult	new	NF-VC500

How to Import

Go to Products page or choose CSV in the Setup Wizard
Upload your CSV file
Map columns if they don't match the template headers
Click Import: products are created or updated

Overwrite mode: If a product with the same product_url already exists, it will be updated with the new data.

Key Differences from Scraper/Feed

Feature	CSV	Scraper/Feed
Edit products	✅ Full edit (title, price, description, etc.)	❌ Read-only
Active toggle	✅ Manual control	❌ Derived from stock
Auto-refresh	❌ Not available	✅ Available
Product discovery	❌ Not available	✅ Available
Brand detection	From CSV column	From site/feed data

Tip: To update CSV products, prepare an updated CSV and re-import with overwrite mode.