Skip to content
Back to Articles

PrestaShop CSV Product Import: build the right file before you click Import

Bulk product creation & updates
CSV
reference,name,price,quantity
SKU-001,Basic Tee,19.90,12
SKU-002,Cargo Short,29.90,7

CSV → NORMALIZE
    → VALIDATE
    → MAP
    → IMPORT
Import & Export
Beginner → Intermediate
PrestaHacks 3 min read

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

TEXT
reference / SKU

2. Profile the source file

TEXT
TOTAL ROWS:          4,218
EMPTY SKU:              12
DUPLICATE SKU:           8
EMPTY NAME:              3
INVALID PRICE:           5
MISSING IMAGE URL:     214

3. 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:

TEXT
19.90
20 EUR
17,50
Call us

Machine-friendly:

TEXT
19.90
20.00
17.50

5. 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

TEXT
SOURCE CATEGORY
        ↓
NORMALIZE
        ↓
CATEGORY MAPPING
        ↓
PRESTASHOP CATEGORY

7. 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

TEXT
SUPPLIER FILE
      ↓
RAW DATA
      ↓
CLEAN
      ↓
NORMALIZE
      ↓
VALIDATE
      ↓
PRESTASHOP-READY DATA
      ↓
IMPORT
      ↓
VERIFY

10. 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

TEXT
CSV IMPORT
    ↓
PRESTASHOP
    ↓
SQL AUDIT

14. Reusable import pipeline

TEXT
Supplier CSV
      ↓
Google Sheets / Script
      ↓
Normalize
      ↓
Validate
      ↓
Category Mapping
      ↓
PrestaShop-ready CSV
      ↓
Import
      ↓
Audit

Tip

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.

STAY TUNED

Get practical PrestaShop hacks in your inbox.

INACTIVE