Importare un CSV WooCommerce senza installare plugin

WooCommerce include un importatore CSV nativo dalla versione 3.1 (2017). La maggior parte dei tutorial vi dice di installare WP All Import o WooCommerce Product CSV Import Suite. Raramente necessario. Il modulo nativo copre il 90 % dei casi, gratis, senza plugin aggiuntivo.

Ecco il metodo, la struttura CSV esatta e le trappole specifiche di WooCommerce (categorie gerarchiche, attributi vs varianti).

Il modulo nativo: dove e come

Nel vostro admin WordPress: Products → All Products, in alto due pulsanti:

Import — importare un CSV
Export — esportare tutti i prodotti

Questo modulo gestisce create + update via SKU o id, supporta attributi, categorie, tag, elabora le varianti, permette dry-run.

Non supportato nativamente: mapping complesso con trasformazioni, import di immagini via FTP, mapping condizionale. Per questi casi avanzati un plugin è necessario.

La struttura CSV WooCommerce

Colonne principali:

Colonna	Funzione
`ID`	Vuoto per creazione, compilato per update
`SKU`	Identificatore univoco (per match)
`Name`	Nome del prodotto
`Type`	`simple`, `variable`, `variation`
`Description`	Descrizione completa (HTML)
`Regular price`	Prezzo normale
`Stock quantity`	Quantità in stock
`Categories`	Categorie separate da virgola
`Images`	URL separate da virgola
`Attribute 1 name`, `Attribute 1 value(s)`	Primo attributo

Ogni riga = un prodotto semplice o una variazione. Un prodotto variabile si descrive su 1 riga genitore + N righe figlie.

Categorie gerarchiche: la trappola WooCommerce

WooCommerce gestisce categorie su più livelli:

Abbigliamento
├── Uomo
│   ├── Scarpe
│   └── Camicie
└── Donna

Per assegnare un prodotto a "Abbigliamento > Uomo > Scarpe":

Categories
"Abbigliamento > Uomo > Scarpe"

Separatore: > con spazi. Se una categoria non esiste, WooCommerce la crea automaticamente.

Errore frequente: dimenticare gli spazi attorno al >. Senza spazi (Abbigliamento>Uomo>Scarpe), WooCommerce crea una sola categoria con questo nome letterale.

Attributi vs varianti

La classica confusione.

Attributo globale (Attribute 1 name = Taglia, valori 42, 43, 44): una caratteristica mostrata sulla pagina prodotto, utilizzabile per il filtraggio. Non crea varianti.

Variazione (riga con Type = variation, Parent = sku-del-genitore): una declinazione acquistabile con proprio prezzo, stock, SKU.

Per taglie/colori, di solito volete varianti (permette di tracciare lo stock per variante):

SKU,Type,Name,Parent,Attribute 1 name,Attribute 1 value(s),Regular price
DERBY-BLK,variable,Derby Pelle,,,Taglia,"42, 43, 44",
DERBY-BLK-42,variation,,DERBY-BLK,Taglia,42,149.00
DERBY-BLK-43,variation,,DERBY-BLK,Taglia,43,149.00

Update vs create: match per SKU

WooCommerce fa match prima per ID, poi per SKU se ID è vuoto.

Per creare nuovi prodotti: lasciate ID vuoto, usate SKU unici.

Per aggiornare prodotti esistenti: compilate ID o SKU esistenti. Selezionate "Update existing products" all'import.

Immagini: URL esterne o upload preliminare

URL esterne (raccomandato per grandi import): il CSV contiene URL pubbliche di un CDN. WooCommerce scarica durante l'import.

Upload preliminare: immagini in Media Library, poi riferimento tramite URL Media Library. Nessun download durante l'import, più affidabile per grandi volumi.

FAQ

Perché il modulo nativo basta nel 90 % dei casi?

Perché la maggior parte degli import sono semplici: create/update per SKU con mapping diretto. Plugin come WP All Import aggiungono: mapping con trasformazioni, scheduling, import da XML/JSON, supporto multi-site. Utili per grandi integrazioni, rari per uno shop e-commerce classico.

Importare un CSV WooCommerce senza installare plugin