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.
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).
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.
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).
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.
Sì. Esporti tutto, tieni solo le colonne Handle + Variant SKU + le colonne da modificare, elimini le altre colonne dal CSV. Shopify farà il match tramite SKU e toccherà solo le colonne presenti.
Se il tuo CSV contiene una colonna Image Src con un URL diverso da quello esistente, sì — Shopify scarica la nuova immagine e sostituisce. Se non vuoi modificare le immagini, elimina le colonne Image Src e Image Alt Text dal CSV.
Passando da Published = FALSE/Status = draft e pubblicando a batch una volta validato. Il catalogo attivo non viene toccato durante l'import. Nessun downtime visibile lato cliente.
Shopify aggiorna il prodotto esistente (match tramite Handle). Le colonne del CSV sovrascrivono i valori esistenti. Le colonne assenti nel CSV vengono preservate.
No, non tramite il CSV prodotto. Le reviews si gestiscono tramite Shopify Product Reviews (export/import dedicato nell'app) oppure tramite il tuo provider reviews (Yotpo, Judge.me).
Per gestire i tuoi import Shopify con preview, rollback e revisione qualità IA, vedi Ecomptimize per Shopify.