Download Wix Product Import Template (CSV) - Free
Download a free Wix product import CSV template with example data. Learn how every column works and bulk import products into your Wix store in minutes.
Download Wix Product Import Template (CSV)
Looking for a Wix product CSV template that works with Wix's built-in product importer? The format is tricky - Wix expects very specific column headers like handleId, fieldType, and productOptionDescription that aren't obvious from the documentation.
We've built a free Wix product import CSV template based on the exact format Wix Stores expects. It includes 3 example products with real data - including variants, images, collections, and additional info sections - so you can see exactly how every column should be filled in.
Download it, replace the examples with your own products, and import directly into your Wix store.
What's in the Wix CSV template?
The Wix product import template includes all the columns Wix Stores expects, pre-filled with 3 example products:
- A simple product (Lavender Scented Candle) with a sale ribbon, discount, and additional info sections
- A product with variants (Ceramic Mug Set) using dropdown colour options and multiple images
- A product with size options (Linen Tote Bag) with sustainability info
Delete the example rows, replace them with your own products, and import directly into Wix.
Wix CSV column guide: every field explained
Here's what every column in the Wix product import CSV template does and how to fill it in correctly:
Product identity
| Column | Required? | What it does |
|---|---|---|
| handleId | Yes | A unique URL-friendly identifier for the product (e.g. lavender-scented-candle). Used as the product page slug. Must be lowercase with hyphens. |
| fieldType | Yes | Must be Product for the main product row. Use Variant for variant rows that share the same handleId. |
| name | Yes | The product title displayed on your Wix store. Maximum 80 characters recommended. |
| sku | Recommended | A unique stock-keeping unit identifier for inventory tracking. |
Content & media
| Column | Format | What it does |
|---|---|---|
| description | HTML | The full product description. Supports HTML tags for formatting (paragraphs, bold, lists). |
| productImageUrl | URL(s) | Full image URLs. For multiple images, separate URLs with semicolons (;). The first image becomes the main product image. |
| collection | Text | The Wix collection (category) this product belongs to. Must match an existing collection name or Wix will create one. |
| ribbon | Text | A badge label displayed on the product (e.g. Sale, New, Best Seller). Leave blank for no ribbon. |
| brand | Text | The product brand name. Displayed on the product page if your Wix theme supports it. |
Pricing & discounts
| Column | Format | What it does |
|---|---|---|
| price | Number | The product price (e.g. 24.99). No currency symbol - Wix uses your store's currency setting. |
| surcharge | Number | An additional cost per variant. Leave blank for most products. |
| cost | Number | Your cost price (for profit tracking). Not displayed to customers. |
| discountMode | AMOUNT or PERCENT | How the discount is applied - as a fixed amount or a percentage. |
| discountValue | Number | The discount amount. For example, 5 with AMOUNT mode takes $5 off. |
Visibility & inventory
| Column | Values | What it does |
|---|---|---|
| visible | true or false | Whether the product is visible on your store. Set to false to save as hidden. |
| inventory | InStock or number | Set to InStock for unlimited stock, or enter a number to track specific inventory levels. |
| weight | Number | Product weight in your store's weight unit. Used for shipping calculations. |
Product options (variants)
Wix supports up to 6 product option sets. Each set has three columns:
| Column | Format | What it does |
|---|---|---|
| productOptionName1 | Text | The option label (e.g. Color, Size, Material). |
| productOptionType1 | DROP_DOWN or COLOR | How the option is displayed. DROP_DOWN for text options, COLOR for colour swatches. |
| productOptionDescription1 | Semicolon-separated | The available values, separated by semicolons (e.g. Small;Medium;Large or Red;Blue;Black). |
Repeat with productOptionName2 through productOptionName6 for additional option sets.
Additional info sections
Wix supports up to 6 additional info sections - collapsible panels on the product page for details like shipping, care instructions, or sizing guides.
| Column | Format | What it does |
|---|---|---|
| additionalInfoTitle1 | Text | The section heading (e.g. Shipping & Returns). |
| additionalInfoDescription1 | Text or HTML | The section content. Supports basic HTML formatting. |
Custom text fields
| Column | Format | What it does |
|---|---|---|
| customTextField1 | Text | A custom input field label shown to customers (e.g. Engraving Text). |
| customTextCharLimit1 | Number | Maximum characters allowed in the custom field. |
| customTextMandatory1 | true or false | Whether the customer must fill in this field before adding to cart. |
How to import a product CSV into Wix (step by step)
- Download the Wix product CSV template above and open it in Google Sheets, Excel, or any spreadsheet editor.
- Replace the example products with your own data. Keep the header row intact - Wix needs the exact column names.
- For products with multiple images, separate URLs with semicolons (
;) in theproductImageUrlcolumn. - For products with variants, fill in the
productOptionName,productOptionType, andproductOptionDescriptioncolumns. UseDROP_DOWNfor the type and separate values with semicolons. - Save / export as CSV (UTF-8).
- In your Wix dashboard, go to Store Products, click the ... menu, and select Import.
- Upload your CSV file, review the column mapping, and click Import.
- Once complete, check your products under Store Products in the Wix dashboard.
Wix CSV import tips: avoid common mistakes
- Always save as UTF-8 CSV - this prevents special characters and accents from breaking during import.
- Use semicolons for multi-value fields - Wix uses semicolons (
;) to separate multiple images and variant options, not commas. - handleId must be unique - each product needs a unique handle. Use lowercase letters and hyphens only (e.g.
blue-cotton-tshirt). - Set fieldType correctly - use
Productfor the main row. If adding variant-specific rows, useVariantwith the samehandleId. - Use full image URLs - Wix needs publicly accessible URLs starting with
https://. Local file paths will not work. - Test with a small batch first - import 3-5 products to verify formatting before uploading your full catalogue.
- Collections are created automatically - if the collection name in your CSV doesn't exist yet, Wix will create it during import.
A faster alternative: skip the Wix CSV entirely
If you'd rather not wrestle with Wix's CSV format at all, Product Upload has a native Wix app that installs directly into your Wix dashboard. Paste any product URL from any supplier website and Product Upload imports it directly into your Wix store - no CSV file, no column mapping, no spreadsheet editing.
Every listing is rewritten by AI with original, SEO-optimised content. Images, variants, pricing, and collections are all handled automatically.
You can also use Product Upload to auto-generate Wix-formatted product CSV files from any supplier website. Import products into the dashboard, select the ones you want, click “Send to Platform”, choose Wix, and download a perfectly formatted CSV ready for Wix's built-in product importer.