Importare un CSV Shopify senza rompere il catalogo

Il CSV Shopify è allo stesso tempo il modo migliore e peggiore per gestire un catalogo. Migliore: è il formato nativo, ufficiale, che permette di modificare 10.000 prodotti in una sola passata. Peggiore: un CSV strutturato male può duplicare, sovrascrivere o eliminare il tuo catalogo in 3 minuti senza alcuna richiesta di conferma.

Ecco la struttura esatta, le 6 colonne da non modificare mai in massa e la procedura di rollback per recuperare rapidamente in caso di problema.

La struttura di un CSV Shopify nativo

Esporta un prodotto dal tuo admin Shopify (Products → Export) per vedere la struttura ufficiale. Le colonne chiave:

Colonna	Ruolo	Modificabile in bulk?
`Handle`	Identificatore univoco (= slug URL)	⚠️ Mai
`Title`	Nome del prodotto	✅ Sì
`Body (HTML)`	Descrizione	✅ Sì
`Vendor`	Marca/fornitore	✅ Sì
`Type`	Tipo di prodotto	✅ Sì
`Tags`	Tag (separati da virgola)	✅ Sì, con prudenza
`Published`	Pubblicato sì/no (`TRUE`/`FALSE`)	✅ Sì
`Option1 Name`, `Option1 Value`	Nome + valore della prima variante	⚠️ Mai
`Option2 Name`, `Option2 Value`	Seconda variante	⚠️ Mai
`Option3 Name`, `Option3 Value`	Terza variante	⚠️ Mai
`Variant SKU`	Codice SKU della variante	⚠️ Mai
`Variant Price`	Prezzo della variante	✅ Sì
`Variant Compare At Price`	Prezzo barrato (prezzo precedente)	✅ Sì
`Variant Inventory Qty`	Quantità a magazzino	✅ Sì
`Image Src`	URL immagine	✅ Sì
`Image Alt Text`	Alt text immagine	✅ Sì
`SEO Title`	Title SEO	✅ Sì
`SEO Description`	Meta description	✅ Sì
`Status`	`active`/`archived`/`draft`	✅ Sì, con prudenza

Ogni riga = uno SKU, non un prodotto. Un prodotto con 3 varianti = 3 righe che condividono lo stesso Handle.

Le 6 colonne che non vanno mai modificate in massa

Queste colonne sono le chiavi di integrità del tuo catalogo. Modificarle con leggerezza rompe tutto:

`Handle`

L'handle genera l'URL pubblico del prodotto. Cambiare un handle:

Cambia l'URL del prodotto (/products/chaussure-derby → /products/chaussure-derby-v2)
Rompe tutti i backlink esterni
Rompe i link interni (email transazionali, menu, annunci Google Shopping)
Fa perdere il ranking SEO accumulato

Regola: non modificare mai un Handle esistente. Solo in fase di creazione di nuovi prodotti.

`Variant SKU`

Lo SKU è la chiave di identificazione delle varianti nel tuo stock, nel tuo WMS e nei tuoi strumenti analitici. Cambiarlo:

Sballa il tuo inventario se usi un sistema esterno (ERP, WMS)
Rompe le integrazioni (fulfillment providers, fornitori dropshipping)
Può creare varianti duplicate se Shopify non riconosce più l'originale

Regola: modifica gli SKU solo prodotto per prodotto, mai in bulk CSV.

`Option1 Name`, `Option2 Name`, `Option3 Name`

I nomi delle opzioni definiscono la struttura delle varianti. Cambiarli dopo la creazione:

Invalida le varianti esistenti (il prodotto con Option1 Name = Taille diventa Option1 Name = Size, creando nuove opzioni)
Crea duplicati silenziosi
Può far esplodere il numero di varianti (da 20 a 200 in pochi secondi)

Regola: i nomi delle opzioni si fissano alla creazione del prodotto, punto. Se devi cambiarli, fallo dall'interfaccia admin prodotto per prodotto.

Preparare il CSV: i 5 controlli prima dell'upload

Prima di qualsiasi import, verifica:

Check 1 — Codifica UTF-8

Apri il CSV in un editor di testo (VS Code, Notepad++). Verifica che accenti e caratteri speciali siano visualizzati correttamente. Se vedi chaÃ®ne invece di chaîne, il CSV è in latin1 o windows-1252. Va riconvertito in UTF-8.

Excel per impostazione predefinita salva in latin1 — evita Excel per modificare un CSV destinato a Shopify. Usa LibreOffice Calc, Google Sheets o VS Code.

Check 2 — Separatore virgola

Il CSV Shopify usa la virgola come separatore. Nelle impostazioni locali italiane, Excel usa spesso il punto e virgola per default. Se all'apertura vedi tutti i dati in una sola colonna, il separatore è sbagliato.

Check 3 — Escape delle virgole nei campi

Se una descrizione contiene una virgola (molto frequente), il campo deve essere racchiuso tra virgolette:

Handle,Title,Body (HTML)
derby-cuir,"Chaussure Derby en cuir","Élégante, confortable, fabriquée en France"

Senza virgolette, la virgola in "Élégante, confortable" verrebbe interpretata come un nuovo campo e sposterebbe tutto.

Check 4 — Righe duplicate

Un handle che compare 2 volte nel CSV = Shopify tratterà la seconda riga come una variante, non come un nuovo prodotto. Può creare sorprese.

Su Google Sheets o Excel, usa Data → Remove duplicates per pulire.

Check 5 — Caratteri speciali negli URL delle immagini

Image Src deve essere un URL pubblico, accessibile senza auth. Testa 3-5 URL casuali con curl -I https://cdn.example.com/image.jpg — risposta 200 obbligatoria. Se hai URL con spazi o caratteri speciali, fai URL-encode (%20 per lo spazio).

Gestire le varianti senza duplicare

Un prodotto con 3 varianti si descrive su 3 righe CSV:

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price
derby-cuir,Derby Cuir,Taille,42,DERBY-BLK-42,149.00
derby-cuir,,,,,
derby-cuir,,,,,

Riga 1: prodotto completo con Title e Option1 Name Righe 2-3: SOLO l'Handle e i valori della variante (Option1 Value, SKU, Price, ecc.). Non ripetere Title, Body, Vendor, ecc. — altrimenti Shopify li considera modifiche e può duplicare.

Questa è la sintassi CSV Shopify nativa. All'inizio sorprende, ma è rigorosa.

Immagini: Drive vs CDN vs Shopify Files

Tre opzioni per gli URL delle immagini:

Opzione 1 — Google Drive

❌ Non funziona con Shopify. Drive restituisce una pagina HTML, non un'immagine diretta. Shopify fallisce in silenzio.

Opzione 2 — CDN pubblico (Cloudflare Images, Amazon S3 + CloudFront, Bunny CDN)

✅ Consigliato per import grandi. Le immagini sono ospitate fuori da Shopify, poi Shopify le scarica al momento dell'import.

Costo tipico: 1-5 € al mese per 1000 immagini in un CDN.

Opzione 3 — Shopify Files

✅ Upload manuale delle immagini in Content → Files su Shopify, poi uso degli URL Shopify nel CSV. Adatto a cataloghi piccoli (<500 immagini).

Limite: l'upload in Shopify Files è manuale, non scriptabile per 10.000 immagini.

Raccomandazione: CDN pubblico per l'import iniziale, poi Shopify ospita automaticamente le immagini dopo l'import.

Rollback prima della pubblicazione

Shopify non propone un rollback nativo su un import CSV andato male. Ma puoi preparare un rollback in anticipo:

Step 1 — Export prima dell'import

Subito prima dell'import, esporta il catalogo completo (Products → Export → CSV file for Excel, Numbers, or other spreadsheet programs). Salva questo export con la data nel nome (catalog-2026-04-23-prima-import.csv).

Step 2 — Import con pubblicazione in modalità draft

Modifica il tuo CSV in modo che Published = FALSE o Status = draft su tutti i prodotti importati. I prodotti vengono creati ma restano invisibili sullo store.

Step 3 — Verifica manuale

Nell'admin, controlla 20 prodotti importati a caso. Verifica:

Immagini caricate correttamente
Varianti ok
Prezzo corretto
Descrizione pulita

Step 4 — Pubblicazione a batch

Se è tutto corretto, pubblica. Se viene rilevato un problema, ti basta eliminare i prodotti in draft, reimportare il CSV di backup e ripartire.

In caso di danno serio

Se l'import ha sovrascritto il tuo catalogo attivo senza passare per draft:

Importa immediatamente il tuo CSV di backup — riscriverà lo stato attuale
URL e reviews vengono preservati (Shopify li identifica tramite Handle)
Considera 1-2 ore perché Google esegua di nuovo il crawl e riposizioni

Alternative al CSV nativo: quando passare a uno strumento specializzato

Il CSV nativo è potente ma pesante. Per operazioni regolari su >1000 prodotti:

Matrixify (ex Excelify): il più completo, gestisce relazioni complesse, ~20 $/mese
Shopify Flow: automazione interna Shopify, ideale per trigger (stock basso, tag, ecc.)
Ecomptimize: ottimizza descrizioni, meta e SEO su tutto il catalogo; il file sorgente resta scaricabile per 30 giorni per reimportare in caso di problemi

Per la riscrittura massiva delle descrizioni con controllo qualità, uno strumento dedicato batte nettamente il CSV. Vedi Ecomptimize per Shopify.

Importare un CSV Shopify senza rompere il catalogo