L'import di prodotti WooCommerce non funziona: le soluzioni

WooCommerce include un importatore CSV discreto, ma fallisce in modi che sembrano un plugin rotto quando in realtà il colpevole è il file. L'import si blocca al 30 %, o finisce con metà dei prodotti mancanti, o crea ogni variazione come prodotto a sé.

Ecco cosa succede davvero.

L'import si blocca o va in timeout

I cataloghi grandi sono il caso classico. L'importatore percorre il file a lotti tramite richieste AJAX successive: se i limiti PHP del tuo server interrompono un lotto, l'intera esecuzione si ferma — di solito senza alcun errore, solo una barra di avanzamento che smette di muoversi.

La soluzione, nell'ordine da provare:

1. Dividi il file. Duemila righe per volta è una dimensione sicura su hosting condiviso.
2. Aumenta max_execution_time e memory_limit in PHP. Molti hosting li espongono dal pannello di controllo.
3. Se puoi modificare il functions.php del tema, riduci la dimensione dei lotti:

add_filter('woocommerce_product_import_batch_size', fn () => 10);

Comincia dal dividere il file. Risolve nella maggior parte dei casi e non costa nulla.

«Esiste già un prodotto con questo SKU»

Gli SKU sono univoci in un negozio WooCommerce. L'importatore rifiuta ogni riga il cui SKU è già occupato e la segnala come fallita.

Dietro lo stesso messaggio si nascondono due situazioni diverse:

• Volevi aggiornare. La riga è corretta: devi solo lanciare l'importatore in modalità aggiornamento. Nella schermata di caricamento, spunta «Aggiorna prodotti esistenti». La corrispondenza avviene prima su ID, poi su SKU.
• Il tuo file contiene davvero duplicati. Frequentissimo quando un listino fornitore ripete un codice tra fogli diversi. Deduplica prima di importare.

Per individuarli in Excel: seleziona la colonna SKU, Home → Formattazione condizionale → Regole evidenziazione celle → Valori duplicati.

Tutto finisce in una sola colonna

Il tuo CSV è delimitato da punti e virgola. Le versioni italiana, francese, tedesca e spagnola di Excel scrivono ; perché la virgola è il separatore decimale.

La soluzione. WooCommerce sa gestirlo — non serve riformattare. Nella schermata di import, apri le «Opzioni avanzate» e inserisci ; nel campo delimitatore CSV. In alternativa, salva il file in CSV UTF-8 delimitato da virgole.

Accenti rovinati

Caffè arriva come Caffè quando il file è in Windows-1252 invece che in UTF-8. WooCommerce non offre alcuna opzione di codifica: il file deve essere corretto.

La soluzione. In Excel, Salva con nome → CSV UTF-8 (delimitato da virgole), la voce di formato dedicata.

Le variazioni diventano prodotti separati

I prodotti variabili richiedono due tipi di riga, collegate tra loro:

• Il genitore: Type impostato su variable, con Attribute 1 name (per esempio Taglia) e Attribute 1 value(s) che elenca tutte le opzioni separate da virgole (S, M, L).
• Una riga per variazione: Type impostato su variation, Parent valorizzato con lo SKU del genitore, e Attribute 1 value(s) contenente il valore di quella singola variazione (M).

Se la colonna Parent è sbagliata — o vuota — ogni variazione diventa un prodotto autonomo. Assicurati anche che la riga del genitore compaia prima delle sue variazioni nel file.

Categorie non create, o create piatte

La colonna Categories usa > per la gerarchia e , per separare più categorie:

Arredamento > Sedie, Saldi

Il prodotto finisce in Sedie (sotto Arredamento) e in Saldi. Usare / o | crea semplicemente una categoria piatta dal nome strano.

Prezzi ignorati

Regular price e Sale price devono essere numeri puri, con il punto come separatore decimale e senza simbolo di valuta. 29,90 € non viene letto come prezzo e il campo resta vuoto.

La soluzione. Imposta le colonne prezzo in formato Testo e scrivi 29.90. Cambiare come Excel visualizza il numero non basta — controlla cosa c'è davvero nel CSV salvato.

Immagini non collegate

La colonna Images accetta URL pubblici completi, separati da virgole, e il primo diventa l'immagine in evidenza. WooCommerce scarica e importa ciascuna durante l'import, ed è anche il motivo per cui i file ricchi di immagini sono lenti. I percorsi locali e gli URL dietro autenticazione vengono saltati.

Checklist prima dell'import

• File sotto le ~2.000 righe, o limiti PHP alzati
• SKU univoci, o modalità aggiornamento attivata di proposito
• Delimitatore indicato nelle opzioni avanzate, o file con virgole
• Salvato in CSV UTF-8
• Le righe di variazione portano uno SKU Parent e seguono il genitore
• Categorie con > e ,
• Prezzi come numeri puri con il punto
• URL immagini pubblici e assoluti

Quando è un file fornitore ricorrente

Impostarlo una volta per una migrazione di catalogo va benissimo.

Ricostruirlo ogni settimana dal listino di un fornitore è dove smette di essere ragionevole. Importly mappa le colonne del fornitore sui nomi WooCommerce (Name, SKU, Regular price, Categories, Weight (kg), Stock, Images), converte i prezzi in decimali semplici, normalizza pesi, quantità di magazzino e URL delle immagini, corregge la codifica ed elimina le righe vuote. Salva la mappatura una volta come profilo e il file della settimana successiva passa per regole identiche. Le righe genitore e variazione restano a te: Importly pulisce nomi di colonne e valori, non rimodella la struttura delle righe.

Pulisci il tuo primo export gratis →