Devi caricare nuovi prodotti o aggiornare il catalogo Shopify con un file CSV? Parti da un tracciato corretto e verifica un campione prima di applicare modifiche a tutto il negozio.
Un foglio che sembra ordinato può contenere associazioni sbagliate tra prodotti, varianti e immagini. L’obiettivo non è soltanto ottenere un’importazione senza errori: è sapere quali dati saranno creati o sostituiti e controllare che il negozio mostri esattamente ciò che intendevi vendere.
Indice della guida
Decidi se stai creando prodotti o modificando quelli esistenti
Scrivi prima il risultato atteso: aggiungere una nuova collezione, cambiare prezzi oppure completare descrizioni. Evita di unire obiettivi diversi nello stesso caricamento se non hai ancora verificato il tracciato. Per poche modifiche, valuta se l’editor in blocco del pannello è più semplice da controllare.
Prepara un elenco dei prodotti coinvolti e dei campi da cambiare. Aggiungi anche ciò che deve restare invariato, come immagini, opzioni e SKU. Questa lista diventa il riferimento per il collaudo. Se stai cambiando piattaforma, consulta prima la guida alla migrazione da WooCommerce a Shopify.
Conserva l’esportazione e usa il tracciato del negozio
Da Prodotti, esporta i dati attuali prima di lavorare. Conserva il file originale senza modificarlo e crea una copia di lavoro. Per un catalogo nuovo usa il modello fornito dalla documentazione Shopify sul CSV prodotti; per uno esistente parti dall’esportazione del negozio.
Mantieni le intestazioni previste e salva in CSV UTF-8. Non tradurre liberamente i nomi delle colonne. Controlla che il programma di fogli di calcolo non trasformi codici con zeri iniziali, valori lunghi o separatori decimali. Evita ordinamenti casuali: possono separare varianti e immagini dal prodotto a cui appartengono.
Organizza file originale, campione e versione finale in cartelle riconoscibili. Non chiamare ogni tentativo “catalogo definitivo”: indicare obiettivo e versione riduce gli scambi accidentali.
Controlla handle e associazioni delle varianti
L’handle identifica il prodotto nel tracciato; non usare il titolo o lo SKU come sostituti senza verificare la struttura. Per le varianti mantieni coerenti opzioni, combinazioni e righe dello stesso prodotto. Usa sempre un’esportazione campione come riferimento per i campi effettivamente presenti.
Esempio ipotetico: un negozio vende una maglietta blu in tre taglie. Le righe devono rappresentare le tre combinazioni previste senza trasformarle in tre prodotti indipendenti. Confronta taglia, codice e prezzo con una lista preparata prima dell’importazione.
Modificare i valori delle opzioni può ricreare gli identificatori delle varianti e incidere sulle app collegate. Se devi riorganizzare taglie o colori, tratta l’intervento come una modifica strutturale e concorda la verifica con chi segue le integrazioni.
Prepara URL delle immagini accessibili e pertinenti
Il CSV contiene indirizzi delle immagini, non fotografie incorporate. Verifica che ogni URL apra direttamente il file senza login. Se la foto proviene dal vecchio sito, mantienila raggiungibile durante il caricamento. I riferimenti esportati da Shopify dipendono dalla disponibilità dei file.
Crea un campione con più foto e varianti: controlla immagine principale, ordine della galleria e associazioni. Usa descrizioni alternative brevi che identifichino ciò che appare. Non assumere che un indirizzo sia corretto perché termina con un’estensione immagine: aprilo e confrontalo con il prodotto.
Conserva gli originali separatamente, soprattutto quando stai sostituendo una fonte esterna. Una cartella di immagini ben nominata aiuta anche a correggere rapidamente gli abbinamenti sbagliati.
Leggi le conseguenze della sovrascrittura prima di confermare
Nella procedura di importazione Shopify, l’opzione di sovrascrittura aggiorna i prodotti con handle corrispondente. Senza questa opzione le corrispondenze vengono ignorate. Una colonna facoltativa presente ma vuota può svuotare il campo; una colonna facoltativa omessa normalmente lascia il valore esistente.
Esistono però dipendenze tra campi: non ridurre il file eliminando colonne a caso. Per un aggiornamento prezzi conserva una struttura coerente delle varianti e verifica il campione. Non attivare la sovrascrittura come tentativo generico per “far passare” un errore.
Prima della conferma scrivi quanti prodotti ti aspetti di creare e quanti di modificare. Se l’anteprima indica qualcosa di diverso, interrompi la preparazione e controlla il file.
Esegui un caricamento piccolo e verifica il risultato
Scegli pochi prodotti rappresentativi: uno semplice, uno con varianti e uno con più fotografie. Quando possibile, svolgi le prove in un ambiente dedicato con chi segue il negozio. Per prodotti nuovi verifica che restino non pubblicati finché non hai concluso i controlli.
- Apri Prodotti e avvia l’importazione del campione.
- Carica il file e leggi l’anteprima.
- Controlla sovrascrittura e pubblicazione prima di confermare.
- Attendi l’esito e annota le eventuali righe segnalate.
- Apri le schede e confrontale con la lista di controllo.
Un’importazione avviata non può essere annullata come una semplice modifica nel foglio. Non lanciare subito un secondo caricamento per compensare un risultato ancora poco chiaro.
Correggi la causa dell’errore senza moltiplicare i tentativi
Conserva il messaggio completo e individua la riga indicata. La guida Shopify agli errori CSV distingue problemi di intestazioni, virgolette, quantità, categorie e immagini. Un handle già esistente può essere ignorato; un indirizzo immagine errato impedisce il download.
- Intestazioni non valide: confronta la prima riga con il modello e cerca spazi aggiunti.
- Virgolette o codifica: controlla il file con un editor di testo e correggi il campo indicato.
- Quantità non numeriche: individua simboli o testo nella colonna coinvolta.
- Immagine non caricata: prova l’URL senza accesso all’account.
Correggi una causa alla volta sul campione e conserva il risultato. Non cambiare tutti gli handle per aggirare gli errori: potresti creare prodotti duplicati.
Controlla negozio, scorte e canali dopo l’importazione
Confronta il numero di prodotti e varianti con quello previsto, ma verifica anche il contenuto. Apri pagine da telefono, seleziona tutte le opzioni del campione e prova il carrello. Controlla prezzi, descrizioni, immagini, disponibilità e collegamenti interni.
Se lavori con più sedi o servizi di logistica, verifica le scorte nel contesto corretto: la gestione dell’inventario tra sedi e app richiede controlli distinti. Non presumere che un CSV prodotti rappresenti tutte le quantità di ogni magazzino.
Solo dopo il collaudo estendi l’operazione agli altri prodotti in gruppi gestibili. Conserva file utilizzato ed esito, e verifica le sincronizzazioni con i canali commerciali. Per organizzare copie più utili consulta la guida alla protezione del catalogo Shopify.
Domande frequenti
Un CSV aggiorna i prodotti riconoscendo lo SKU?
Nell’importazione nativa l’abbinamento per la sovrascrittura usa l’handle del prodotto. Controlla anche la struttura delle varianti e non sostituire l’handle con lo SKU.
Una cella vuota lascia invariato il valore precedente?
Non necessariamente. Con la sovrascrittura, una colonna facoltativa presente ma vuota può svuotare il campo. Omettere la colonna ha un comportamento diverso, ma vanno rispettate le dipendenze tra campi.
Posso annullare un’importazione già avviata?
Shopify indica che un’importazione CSV avviata non può essere annullata. Conserva le copie precedenti e prova un campione prima delle modifiche estese.
Perché le immagini mancano anche se sono nel file?
Il file contiene URL, non immagini incorporate. Controlla che i collegamenti siano diretti, accessibili pubblicamente e associati alle righe corrette dei prodotti.