Start with the importer's own template
The download uses the same template as the workspace importer. It contains one illustrative product with a blank price and a tag in the center of page 1. Replace that row; it is not a real product or an offer.
Download product CSV templateWhat each column means
| Column | How to fill it |
|---|---|
| sku | Required. A unique, stable identifier; maximum 80 characters. Keep leading zeroes as text in your spreadsheet. |
| name | Required for a new product. The buyer-facing product name. |
| description | Optional product details; up to 2,000 characters. Include pack contents when useful. |
| unit | The selling unit, such as pcs, carton or roll. Up to 24 characters; default pcs when omitted for a new product. |
| price | Optional non-negative number. Leave blank for quote-only products. Do not include a currency symbol or thousands separator. |
| currency | EUR, USD or ILS. Default EUR when omitted for a new product. |
| page | Required for a new product. A whole number starting at 1, within this PDF's page count. |
| x / y | Tag position as a fraction of page width / height, from 0.02 to 0.98. Both default to 0.5 for a new product when omitted or blank. |
Save a clean UTF-8 file
Use CSV UTF-8. The importer accepts comma, semicolon or tab delimiters and quoted text containing delimiters or line breaks. Keep the header names from the template. Upload no more than 500 product rows and a file no larger than 2 MB at a time.
Use one row per SKU. Duplicate SKUs in the same file are errors. If a spreadsheet converts an identifier such as 00125 to 125, restore the intended SKU before exporting; the importer cannot infer lost digits.
sku,name,description,unit,price,currency,page,x,y BOX-01,Sample box,Illustrative sample only,pcs,,USD,1,0.5,0.5
Understand updates before applying them
For an existing SKU, omitted columns keep their previous values. Included fields are processed as supplied: for example, a blank price clears the price. A blank x or y preserves an existing position. A new SKU creates a new product, so changing an identifier is not the same as renaming its product.
The preview separates creates, updates and unchanged products and reports row errors. Check those changes against your intent before applying the import. Products omitted from the file are not deleted by the import.
Review the result on the actual pages
CSV validation can check a page number and coordinate range, but it cannot tell whether the tag points to the right photograph. Inspect imported tags in the editor, then make a buyer selection to confirm the SKU, unit and quantity.
If you are replacing a PDF at the same time, verify the new page order before deciding which page and coordinates to import. Keep the source product list and the approved PDF edition together so the next update is easier to review.