Guida
Come caricare prodotti in blocco su Shopify
Shopify può creare o aggiornare molti prodotti in una volta da un file CSV. Ecco come funziona l’importazione, dove si complica e cosa fare quando i dati di prodotto nascono nei PDF dei fornitori.
L’importazione CSV dei prodotti di Shopify è il modo standard per aggiungere un catalogo in blocco. Prepari un foglio di calcolo nel formato di Shopify, lo carichi nell’area di amministrazione e Shopify crea prodotti, varianti e immagini.
Come per qualsiasi importazione, il successo dipende dai dati che inserisci. Questa guida tratta il procedimento CSV, le alternative e la preparazione che ti evita di dover sistemare centinaia di prodotti in seguito.
Opzione 1: importare un CSV di prodotti nell’area di amministrazione di Shopify
Nell’area di amministrazione di Shopify vai su Prodotti e scegli Importa. Carica un CSV nel formato prodotti di Shopify, decidi se sovrascrivere i prodotti con handle corrispondenti, controlla l’anteprima e conferma. Shopify elabora il file in background e ti avvisa quando ha finito.
- Parti dal modello CSV di esempio dei prodotti di Shopify, oppure esporta un prodotto esistente per vedere le colonne esatte.
- La colonna URL handle (Handle nei modelli meno recenti) identifica un prodotto; le righe con lo stesso handle sono varianti o immagini aggiuntive dello stesso prodotto.
- Le colonne più comuni includono Title, Description (Body (HTML)), Vendor, Product category, Type, Tags, Status, Option1 name / Option1 value, SKU (Variant SKU), Price, Barcodes (Variant Barcode) e Product image URL (Image Src).
- Le immagini vengono recuperate da URL pubblici al momento dell’importazione.
- Salva il file come CSV UTF-8 per mantenere intatti i caratteri speciali.
Gestire correttamente le varianti
Le varianti mettono in difficoltà la maggior parte delle prime importazioni. Ogni prodotto può avere fino a tre opzioni (ad esempio Taglia, Colore, Materiale). La prima riga di un prodotto contiene i campi a livello di prodotto e i nomi delle opzioni; ogni riga successiva con lo stesso handle aggiunge una variante con i suoi valori di opzione, SKU, prezzo e inventario.
Mantieni identici i nomi delle opzioni in tutte le righe e unica la combinazione di valori di opzione di ogni variante, in modo che ogni riga corrisponda esattamente a una variante. Una riga che ha colonne di variante ma non Option1 name e Option1 value fa sì che Shopify crei una variante predefinita ed elimini quelle esistenti.
Opzione 2: app di importazione in blocco
Le app di importazione dello Shopify App Store ampliano il CSV nativo: supporto per Excel e Google Sheets, metacampi, importazioni pianificate da feed dei fornitori e migrazione da altre piattaforme. Vale la pena valutarle quando importi di frequente o servono campi che il CSV standard non copre.
Opzione 3: l’Admin API di Shopify
App e integrazioni personalizzate possono creare prodotti tramite l’API Admin di Shopify anziché con un file CSV. Questo evita del tutto i passaggi avanti e indietro con i fogli di calcolo ed è il modo in cui molti strumenti per cataloghi e inserzioni creano prodotti in Shopify.
Doc2Shelf segue questa strada: colleghi il tuo negozio con OAuth e le inserzioni revisionate vengono create come prodotti in bozza, con immagini, prezzi e categorie.
Preparare i dati di prodotto per Shopify
Prima di qualsiasi caricamento in blocco, verifica che:
- Ogni prodotto abbia un handle univoco e ogni variante uno SKU univoco.
- I titoli seguano un unico schema (ad esempio Marca + Prodotto + Attributo chiave).
- Le descrizioni siano testi tuoi, non il testo del fornitore incollato, e usino HTML semplice.
- Le specifiche usino unità e nomi coerenti, in modo da poter diventare opzioni, tag o metacampi.
- I prodotti siano importati prima come non pubblicati, così puoi controllare un campione prima di andare online.
Quando i dati di prodotto provengono dai PDF dei fornitori
Un’importazione CSV presuppone che tu abbia già dati puliti e strutturati. Quando i fornitori inviano schede delle specifiche e cataloghi in PDF, qualcuno deve prima estrarre titoli, specifiche e identificativi e scrivere le descrizioni, di solito la parte più lenta di tutto il lavoro.
Doc2Shelf sostituisce questo passaggio: legge i PDF dei fornitori, estrae i dati di prodotto con le informazioni di attendibilità per la revisione, prepara il testo dell’inserzione Shopify e crea come bozze i prodotti revisionati nel tuo negozio collegato, senza CSV.
Colonne del CSV prodotti di Shopify: nomi attuali ed equivalenti meno recenti
Shopify ha rinominato diverse colonne del CSV prodotti. Il suo riferimento CSV attuale usa etichette come URL handle, Description, SKU e Barcodes, mentre molti modelli e tutorial mostrano ancora Handle, Body (HTML), Variant SKU e Image Src. Shopify afferma di mantenere la compatibilità con i nomi di colonna meno recenti, quindi un file più vecchio si importa comunque, ma un’esportazione nuova usa le etichette attuali, e un file che mescola i due stili è difficile da controllare.
La tabella riporta le colonne necessarie alla maggior parte dei caricamenti in blocco. Il cambio di nome da Barcode a Barcodes è indicato nella documentazione di Shopify; le altre etichette meno recenti sono associate in base a ciò che contiene ciascun campo, quindi confermale con un’esportazione del tuo negozio. Le intestazioni distinguono tra maiuscole e minuscole.
| Colonna attuale | Cosa contiene | Esempio | Etichetta meno recente o note |
|---|---|---|---|
| Title | Nome del prodotto | Bollitore in acciaio inox 1,7 L | Obbligatoria per creare un prodotto. |
| URL handle | Identificativo univoco del prodotto usato nell’URL del prodotto | steel-kettle | I modelli meno recenti lo chiamano Handle. Le righe con lo stesso handle appartengono a un unico prodotto. |
| Description | Descrizione del prodotto | Bollitore senza fili con… | I modelli meno recenti lo chiamano Body (HTML). |
| Vendor | Marchio o fabbricante | Acme | — |
| Product category | Categoria della Standard Product Taxonomy | hg-15-1-2 | Percorso completo o ID della categoria, non entrambi. |
| Type | Il tuo tipo di prodotto | Bollitore elettrico | Testo libero, a differenza della categoria. |
| Tags | Tag separati da virgole | cordless, kitchen | Fino a 250 tag per prodotto. |
| Status | Stato del prodotto | draft | Importa come bozza, rivedi, poi attiva. |
| SKU | SKU della variante | KTL-SLV | I modelli meno recenti lo chiamano Variant SKU. |
| Barcodes | Codici a barre della variante | gtin:4006381333931 | In precedenza Barcode (e prima ancora Variant Barcode). Separane più di uno con il punto e virgola; il prefisso del tipo è facoltativo. |
| Option1 name / Option1 value | Prima opzione e valore di questa variante | Colore / Argento | Option2 e Option3 seguono lo stesso schema. |
| Option1 LinkedTo | Collegamento dall’opzione a un metacampo della categoria | product.metafields.shopify.[attribute] | Facoltativa; vedi la sezione sulla tassonomia più avanti. |
| Price / Compare-at price | Prezzo di vendita e prezzo di confronto | 49,90 / 59,90 | Le colonne Price / [Market] contengono i prezzi specifici per mercato. |
| Inventory quantity | Scorte disponibili | 25 | Funziona insieme alla colonna Inventory tracker. |
| Weight value (grams) | Peso della variante in grammi | 1200 | I modelli meno recenti lo chiamano Variant Grams. Weight unit for display imposta l’unità visualizzata dagli acquirenti. |
| Product image URL | URL pubblico di un’immagine del prodotto | https://cdn.example.com/kettle.jpg | I modelli meno recenti lo chiamano Image Src. |
| Image position / Image alt text | Ordine della galleria e testo alternativo | 1 / Bollitore in acciaio, vista frontale | Testo alternativo fino a 512 caratteri. |
| Variant image URL | Immagine mostrata quando si seleziona questa variante | https://cdn.example.com/kettle-black.jpg | — |
| SEO title / SEO description | Titolo e meta description per i risultati di ricerca | — | Fino a 70 e 320 caratteri. |
| Colonne dei metacampi | Valori dei metacampi del prodotto | Material (product.metafields.custom.material) | Formato dell’intestazione: Nome (product.metafields.namespace.key). |
Varianti e opzioni: limiti e insidie
Un prodotto Shopify può avere fino a tre opzioni — ad esempio Taglia, Colore e Materiale — e fino a 2.048 varianti. Il limite delle varianti era 100 finché Shopify non lo ha aumentato a ottobre 2025, quindi modelli e guide scritti prima riportano ancora il vecchio numero. Alcuni temi, app e canali di vendita sono stati costruiti attorno al vecchio limite, quindi verifica i tuoi prima di importare un prodotto con centinaia di varianti.
La prima riga di un prodotto contiene i campi a livello di prodotto e i nomi delle opzioni. Ogni riga successiva con lo stesso URL handle aggiunge una variante con il proprio valore di opzione, SKU, prezzo, peso e giacenza, e lascia vuoti i campi a livello di prodotto.
Due comportamenti sorprendono negli aggiornamenti tramite importazione. Se una riga include colonne di variante come SKU o peso ma omette Option1 name e Option1 value, Shopify crea una variante predefinita ed elimina le varianti esistenti. E modificare il valore di un’opzione — ad esempio rinominare “Grigio” in “Grigio chiaro” — elimina gli ID delle varianti e ne crea di nuovi, il che può compromettere app e feed che fanno riferimento a quegli ID.
| Riga | URL handle | Title | Option1 name | Option1 value | SKU |
|---|---|---|---|---|---|
| Prima riga | steel-kettle | Bollitore in acciaio | Colore | Argento | KTL-SLV |
| Riga successiva | steel-kettle | (vuoto) | (vuoto) | Nero | KTL-BLK |
Immagini dei prodotti in un CSV di Shopify
Shopify scarica le immagini dalla colonna Product image URL durante l’importazione, quindi ogni URL deve essere accessibile pubblicamente e puntare direttamente al file immagine. Link che richiedono un login, aprono una pagina di anteprima o scadono prima dell’importazione sono i motivi più comuni per cui le immagini mancano.
Un prodotto può contenere fino a 250 immagini o altri contenuti multimediali. Inserisci la prima immagine nella prima riga del prodotto; aggiungi ogni altra immagine in una riga a sé con lo stesso URL handle, l’URL dell’immagine, la relativa Image position e il relativo Image alt text. Per mostrare una determinata immagine quando l’acquirente sceglie una variante, inserisci il suo URL in Variant image URL nella riga di quella variante.
Il testo alternativo può arrivare a 512 caratteri e Shopify consiglia di usarne 125 o meno. Descrivi ciò che mostra l’immagine — “Bollitore in acciaio inox, vista frontale con indicatore del livello dell’acqua” — anziché ripetere il titolo del prodotto.
Categoria del prodotto, metacampi e Standard Product Taxonomy
La colonna Product category assegna una categoria della Standard Product Taxonomy di Shopify, scelta in base alla funzione principale del prodotto. Inserisci il percorso completo, come Home & Garden > Linens & Bedding > Bedding > Bed Sheets, oppure l’ID della categoria, come hg-15-1-2, ma non entrambi. Un prodotto senza categoria è trattato come non categorizzato.
Impostare una categoria sblocca i relativi metacampi di categoria, che la tassonomia chiama attributi di prodotto. La categoria Shirts di Shopify, ad esempio, ne ha nove, tra cui taglia, scollo, tessuto e colore, e i valori del colore possono essere visualizzati come campioni. La colonna Option1 LinkedTo collega un’opzione di variante a uno di questi metacampi di categoria.
La categoria conta oltre la navigazione: Shopify Tax la usa per stabilire le aliquote. Type, al contrario, è un’etichetta libera che definisci tu, utile per i tuoi filtri e rapporti.
I metacampi personalizzati del prodotto si importano tramite colonne con intestazione Nome (product.metafields.namespace.key), ad esempio Materiale (product.metafields.custom.material). I metacampi delle varianti non sono supportati nel CSV prodotti: impostali nell’area di amministrazione, con un’app o tramite l’API.
Limiti del CSV di Shopify e lunghezze dei campi SEO
Questi sono i limiti che Shopify documenta per le importazioni CSV dei prodotti e per i record prodotto. I numeri nelle guide meno recenti — in particolare il limite di 100 varianti — sono obsoleti.
Le colonne SEO title e SEO description compilano il titolo e la meta description usati nei risultati di ricerca. Scrivile prodotto per prodotto anziché copiare uno schema unico su tutto il catalogo: parti dal nome del prodotto e dall’attributo che gli acquirenti cercano, come taglia, materiale o numero di modello.
| Voce | Limite | Cosa fare |
|---|---|---|
| Dimensione del file CSV | 15 MB | Dividi i cataloghi grandi; tieni tutte le righe di un prodotto nello stesso file. |
| Opzioni per prodotto | 3 | Modella le ulteriori differenze come prodotti separati o metacampi. |
| Varianti per prodotto | 2.048 | Verifica che il tuo tema e le tue app gestiscano un gran numero di varianti. |
| Immagini e contenuti multimediali per prodotto | 250 | Limita la galleria alle immagini che aiutano gli acquirenti a decidere. |
| Tag per prodotto | 250 | Usa i tag per filtri e automazioni. |
| Codici a barre per prodotto o variante | 20 | Aggiungi un prefisso di tipo come gtin: quando conosci il tipo. |
| SEO title | 70 caratteri | Parti dal nome del prodotto e dall’attributo chiave. |
| SEO description | 320 caratteri | Riassumi il prodotto mettendo prima i dettagli chiave. |
| Testo alternativo dell’immagine | 512 caratteri (consigliati 125 o meno) | Descrivi ciò che mostra l’immagine. |
Sovrascrivere o creare: come si comportano gli aggiornamenti
Per creare un prodotto, il CSV richiede solo un Title; per aggiungere varianti serve anche l’URL handle. Per aggiornare un prodotto esistente, Shopify richiede URL handle e Title, e all’avvio dell’importazione scegli di sovrascrivere i prodotti con handle corrispondente.
Considera una sovrascrittura come definitiva per ogni colonna che includi. Lo schema più sicuro è esporta, modifica, reimporta: esporta i prodotti che vuoi cambiare, modifica solo le celle che richiedono modifiche, lascia al loro posto le colonne delle opzioni e importa il file modificato con la sovrascrittura attivata. Un file scarno costruito da zero rende facile innescare il comportamento di eliminazione delle varianti descritto sopra.
Leggi l’anteprima dell’importazione prima di confermare ed esegui un aggiornamento esteso prima su pochi prodotti. L’esportazione fatta prima della modifica è la tua via di ritorno se qualcosa va storto.
Checklist prima dell’importazione e risoluzione dei problemi
Segui questi passaggi prima di un’importazione estesa; la tabella che segue copre i problemi più frequenti.
- Esporta un prodotto dal tuo negozio e riutilizza la sua riga di intestazione, in modo che i nomi delle colonne coincidano esattamente.
- Assegna a ogni prodotto un URL handle univoco e a ogni variante uno SKU univoco.
- Controlla che nomi e valori delle opzioni siano scritti in modo coerente e verifica che ogni riga di variante abbia il proprio valore di opzione.
- Compila Product category con un percorso o un ID copiato dalla tassonomia.
- Apri un campione di URL di immagini in una finestra del browser privata per confermare che si carichino senza login.
- Imposta Status su draft per la prima esecuzione.
- Salva come CSV UTF-8 e verifica che il file sia inferiore a 15 MB.
- Importa da cinque a dieci prodotti, controllali nell’area di amministrazione e nel negozio, poi importa il resto.
| Problema | Causa probabile | Soluzione |
|---|---|---|
| File rifiutato | Più grande di 15 MB oppure non salvato come CSV UTF-8 | Dividi il file per prodotto e salvalo di nuovo come CSV UTF-8 |
| Colonna ignorata | Intestazione scritta male o con maiuscole diverse | Copia le intestazioni da un’esportazione recente |
| Varianti scomparse dopo un aggiornamento | Colonne di variante inviate senza Option1 name e value | Reimporta includendo le colonne delle opzioni |
| Le app hanno perso traccia delle varianti | Un valore di opzione è stato rinominato, creando nuovi ID di variante | Rinomina i valori delle opzioni con cognizione e ricollega le app interessate |
| Prodotti divisi o uniti in modo errato | L’URL handle differisce tra le righe di uno stesso prodotto | Usa un unico handle identico per prodotto |
| Immagini mancanti | URL non pubblico, non un link diretto al file o scaduto | Ospita le immagini su URL pubblici stabili |
| Categoria non impostata | Percorso scritto male, oppure indicati sia percorso sia ID | Usane esattamente uno, copiato dalla tassonomia |
| Codice a barre non accettato | La lunghezza non corrisponde al tipo indicato | GTIN: 8, 12, 13 o 14 cifre; UPC: 8 o 12; EAN: 8 o 13 |
| Valori dei metacampi mancanti | Formato di intestazione errato, oppure metacampo di variante | Usa Nome (product.metafields.namespace.key); imposta altrove i metacampi delle varianti |
Domande frequenti
- Come posso caricare prodotti in blocco su Shopify gratuitamente?
- Usa l’importazione CSV integrata in Prodotti → Importa. È inclusa in ogni piano Shopify e gestisce prodotti, varianti e immagini da un file CSV nel formato di Shopify.
- Posso caricare prodotti su Shopify da Excel?
- L’importatore nativo richiede il CSV, quindi salva il tuo foglio Excel come CSV UTF-8 con i nomi di colonna di Shopify. Alcune app di importazione possono leggere direttamente i file Excel.
- Un’importazione CSV sovrascriverà i miei prodotti esistenti?
- I prodotti esistenti vengono aggiornati solo se scegli l’opzione per sovrascrivere i prodotti con handle corrispondenti. Controlla l’anteprima dell’importazione prima di confermare e prova prima con un file piccolo.
- Perché le mie immagini non vengono importate?
- Gli URL delle immagini devono essere link diretti pubblicamente accessibili a file immagine. I link che richiedono un login, reindirizzano a una pagina web o provengono da una condivisione temporanea di file di solito non funzionano.
- Quali colonne sono obbligatorie in un CSV prodotti di Shopify?
- Per creare un prodotto è obbligatorio solo Title, più l’URL handle quando aggiungi varianti. Per aggiornare prodotti esistenti servono URL handle e Title. Tutto il resto è facoltativo, anche se un’inserzione utilizzabile richiede normalmente prezzo, SKU, categoria, descrizione e immagini.
- Quante varianti può avere un prodotto Shopify?
- Fino a 2.048 varianti, con un massimo di tre opzioni. Shopify ha portato il limite da 100 a 2.048 a ottobre 2025, quindi i modelli e le guide meno recenti che indicano 100 sono superati.
- Posso importare i metafield con un CSV di Shopify?
- I metafield di prodotto sì: aggiungi una colonna con intestazione Name (product.metafields.namespace.key). I metafield delle varianti non sono supportati nel CSV dei prodotti e vanno impostati dall’area di amministrazione, con un’app o tramite API.
- Qual è la dimensione massima di un CSV di prodotti Shopify?
- Un CSV di prodotti non può superare i 15 MB. Suddividi i cataloghi più grandi in più file e tieni tutte le righe di uno stesso prodotto nello stesso file.