Product Import/Export in Magento 2
Bulk productbeheer via CSV import is essentieel voor webshops met veel producten.
Export: Template maken
Navigatie
System > Data Transfer > Export
Producten exporteren
Gebruik als template
De geëxporteerde CSV toont exact welke kolommen Magento verwacht.
Import: Basis
Navigatie
System > Data Transfer > Import
Import configuratie
- Add/Update: Nieuwe toevoegen, bestaande updaten
- Replace: Vervangt bestaande data volledig
- Delete: Verwijdert producten uit CSV
, (komma),__EMPTY__VALUE__CSV uploaden
Validatie
Magento valideert de CSV:
- Kolom headers correct
- Required fields aanwezig
- Data formats correct
- SKU's geldig
Import uitvoeren
Na succesvolle validatie:
CSV Structuur
Verplichte kolommen
``csv
sku,name,product_type,attribute_set_code,price,qty,is_in_stock,visibility,status
`
Voorbeeld basis product
`csv
sku,name,product_type,attribute_set_code,price,qty,is_in_stock,visibility,status,url_key
SKU001,Product Naam,simple,Default,29.95,100,1,4,1,product-naam
`
Visibility waarden
- 1: Not Visible Individually
- 2: Catalog
- 3: Search
- 4: Catalog, Search
Status waarden
- 1: Enabled
- 2: Disabled
Attributen importeren
Custom attributen
Voeg kolommen toe met attribuut code:
`csv
sku,name,...,merk,kleur,materiaal
SKU001,Product,...,Nike,Zwart,Katoen
`
Dropdown attributen
Gebruik de optie label (niet ID):
`csv
sku,kleur
SKU001,Zwart
`
Magento matcht automatisch met bestaande opties.
Nieuwe opties
Als de optie niet bestaat, wordt deze aangemaakt (indien attribuut dit toestaat).
Categorieën toewijzen
Categorie pad
Gebruik het volledige pad met
/:
`csv
sku,categories
SKU001,Default Category/Kleding/Shirts
SKU002,"Default Category/Kleding/Shirts,Default Category/Sale"
`
Meerdere categorieën
Scheid met komma (binnen quotes als nodig).
Afbeeldingen importeren
Kolommen
`csv
sku,base_image,small_image,thumbnail_image,additional_images
SKU001,/import/product1.jpg,/import/product1.jpg,/import/product1.jpg,"/import/product1-2.jpg,/import/product1-3.jpg"
`
Afbeelding locatie
Plaats afbeeldingen in:
pub/media/import/
Pad in CSV is relatief aan deze folder.
Afbeelding labels
`csv
sku,base_image,base_image_label
SKU001,/import/product1.jpg,"Product 1 voorkant"
`
Configurable products importeren
Stap 1: Simple products
Importeer eerst alle simple product varianten:
`csv
sku,product_type,name,...,kleur,maat
TS-WIT-S,simple,T-shirt Wit S,...,Wit,S
TS-WIT-M,simple,T-shirt Wit M,...,Wit,M
TS-ZWA-S,simple,T-shirt Zwart S,...,Zwart,S
TS-ZWA-M,simple,T-shirt Zwart M,...,Zwart,M
`
Stap 2: Configurable parent
`csv
sku,product_type,name,...,configurable_variations
TS-BASIS,configurable,T-shirt Basis,...,"sku=TS-WIT-S,kleur=Wit,maat=S|sku=TS-WIT-M,kleur=Wit,maat=M|sku=TS-ZWA-S,kleur=Zwart,maat=S|sku=TS-ZWA-M,kleur=Zwart,maat=M"
`
Bulk update bestaande producten
Alleen updaten
Import met "Add/Update" behavior. Alleen kolommen in CSV worden geüpdatet.
Voorbeeld: Alleen prijzen updaten
`csv
sku,price
SKU001,24.95
SKU002,34.95
SKU003,44.95
`
Voorbeeld: Alleen voorraad
`csv
sku,qty,is_in_stock
SKU001,50,1
SKU002,0,0
SKU003,25,1
`
Veelvoorkomende fouten
"Invalid value for column"
Waarde komt niet overeen met verwacht formaat:
- Check dropdown opties bestaan
- Check numerieke velden
- Check date formats
"SKU not found"
Bij update: SKU bestaat niet in systeem.
"URL key already exists"
Duplicate URL key. Maak uniek per product.
"Required attribute missing"
Verplicht attribuut ontbreekt:
- Check attribute set requirements
- Voeg kolom toe aan CSV
Performance tips
Grote imports
Voor duizenden producten:
Split in batches van 5000
Disable indexers tijdens import
Reindex na import
Indexers uitschakelen
`bash
bin/magento indexer:set-mode schedule
# Voer import uit
bin/magento indexer:reindex
`
CLI import
Voor grote bestanden:
`bash
bin/magento import:products /path/to/file.csv
``
(Vereist extensie of custom script)
Best practices
Backup eerst
Maak database backup voor grote imports.
Test op staging
Test CSV eerst op staging omgeving.
Kleine batches
Begin met kleine test batch (<100 producten).
Valideer extern
Check CSV in spreadsheet software voor:
- Encoding (UTF-8)
- Separator consistency
- Quotes rond tekst met komma's
Log errors
Bewaar import logs voor troubleshooting.
Scheduled imports
Voor reguliere imports: overweeg extensies als:
- Firebear Import/Export
- MageDelight Import/Export