PrestaShop CSV Product Import: build the right file before you click Import
reference,name,price,quantity
SKU-001,Basic Tee,19.90,12
SKU-002,Cargo Short,29.90,7
CSV → NORMALIZE
→ VALIDATE
→ MAP
→ IMPORT
The difficult part of a product import is usually not the Import button. It is the file before it gets there.
A CSV may look fine in Excel or Google Sheets and still contain duplicate SKUs, wrong decimal separators, inconsistent categories, invalid image URLs, encoding problems or rows that should really be combinations.
1. Start with the identifier
reference / SKU2. Profile the source file
TOTAL ROWS: 4,218
EMPTY SKU: 12
DUPLICATE SKU: 8
EMPTY NAME: 3
INVALID PRICE: 5
MISSING IMAGE URL: 2143. Build a working dataset
| reference | name | price | quantity | category | image_url |
|---|---|---|---|---|---|
| SKU-001 | Product A | 19.90 | 12 | T-Shirts | https://… |
| SKU-002 | Product B | 24.50 | 5 | T-Shirts | https://… |
4. Clean numeric values
Bad:
€19.90
20 EUR
17,50
Call usMachine-friendly:
19.90
20.00
17.505. Decimal separators and encoding
Do not leave locale assumptions to the import step. Normalize decimal values and verify the file encoding during preflight.
6. Categories need mapping
SOURCE CATEGORY
↓
NORMALIZE
↓
CATEGORY MAPPING
↓
PRESTASHOP CATEGORY7. An image URL is not automatically a valid image
Check reachability, authentication, temporary URLs and SKU association.
8. Simple products or combinations?
| sku | name | size | color |
|---|---|---|---|
| TS01-S-BLK | Basic Tee | S | Black |
| TS01-M-BLK | Basic Tee | M | Black |
| TS01-L-BLK | Basic Tee | L | Black |
This probably describes one product with three combinations, not three unrelated products.
9. Do not transform during import
SUPPLIER FILE
↓
RAW DATA
↓
CLEAN
↓
NORMALIZE
↓
VALIDATE
↓
PRESTASHOP-READY DATA
↓
IMPORT
↓
VERIFY10. Minimum preflight checklist
- reference
- name
- duplicate references
- numeric values
- categories
- manufacturers
- tax rules
- attributes
- images
- encoding
11. Test first
Use a deliberately small sample: one simple product, one product with an image, one mapped category, multilingual text and one product with combinations.
12. Verify after import
Compare expected versus actual products, SKUs, stock, combinations and images.
13. SQL as a verification layer
CSV IMPORT
↓
PRESTASHOP
↓
SQL AUDIT14. Reusable import pipeline
Supplier CSV
↓
Google Sheets / Script
↓
Normalize
↓
Validate
↓
Category Mapping
↓
PrestaShop-ready CSV
↓
Import
↓
AuditTip
Keep the raw supplier file untouched:
01-RAW → 02-WORKING → 03-PRESTASHOP-READY → 04-IMPORT-LOG
Next step
Before importing, normalize supplier labels through a reusable category-mapping layer and validate every remote asset with the product-image workflow. Test both mappings on a small batch before the full catalogue run.