CSV Product Import

Import products in bulk from a CSV file.

Requires: Pro subscription for API access. CSV import in the UI is available on all plans.

CSV format

Column	Required	Description
`name`	Yes	Product name
`sku`	No	Your internal reference code
`category`	No	Category ID (defaults to `textile_apparel`)
`subcategory`	No	e.g., t-shirt, jacket, trousers
`gtin`	No	Barcode / EAN number
`care_instructions`	No	Washing and care info
`expected_lifespan`	No	e.g., “3 years”, “200 washes”
`recyclable`	No	`true` or `false`
`recycling_instructions`	No	How to recycle the product
`ecommerce_url`	No	Product page URL

Valid categories

ID	Name
`textile_apparel`	Apparel
`textile_footwear`	Footwear
`textile_accessories`	Accessories
`textile_home`	Home Textiles
`textile_workwear`	Workwear
`textile_sportswear`	Sportswear
`textile_leather`	Leather Goods

Example CSV

name,sku,category,subcategory,gtin,care_instructions,expected_lifespan,recyclable
Classic Crew T-Shirt,NE-TSH-001,textile_apparel,t-shirt,5701234567001,"Machine wash 30C",3 years,true
Canvas Tote Bag,NE-TOT-006,textile_accessories,bag,,"Machine wash cold",5 years,true
Leather Belt,NE-LBT-097,textile_leather,belt,5701234567088,Wipe clean,7 years,false

How to import

Go to Products in the sidebar
Click Import CSV
Download the template CSV or prepare your own
Select your file — a preview table shows the parsed rows
Review the preview and confirm the import
Results show created, skipped (duplicate SKUs), and errors per row

Handling duplicates

Products with a SKU that already exists in your catalog are skipped (not overwritten). To update existing products, edit them individually or delete and re-import.

Handling errors

Each row is validated independently:

Missing name — error, row skipped
Invalid category — error, row skipped
Missing optional fields — imported with nulls

Errors are shown per-row after import with the specific issue.

Quoted fields

The CSV parser handles quoted fields correctly — values containing commas, newlines, or double quotes work as expected. Escape double quotes by doubling them ("").

API endpoint

POST /brand/bulk/products
Content-Type: multipart/form-data
Authorization: Bearer <token>
X-Organization-Id: <org_id>
 
file: <your-csv-file>

See Products API for response format.

DPPs & QR Codes Integrations