Modificare la SEO di Shopify in blocco via CSV senza rompere il catalogo

Come l’importazione CSV di Shopify gestisce gli aggiornamenti

L’importazione dei prodotti di Shopify fa due cose con lo stesso file: crea nuovi prodotti e aggiorna quelli esistenti. A decidere tra le due è l’handle, l’identificativo univoco che forma anche l’URL del prodotto.

Durante l’importazione, Shopify offre un’opzione chiamata Sovrascrivi prodotti con handle corrispondenti. Se la selezioni, ogni riga il cui handle corrisponde a un prodotto esistente sovrascrive i valori nelle colonne corrispondenti. Se non la selezioni, i prodotti con un handle già esistente vengono ignorati durante l’importazione. Per un aggiornamento SEO l’opzione deve quindi essere attiva, ed è lì che iniziano i rischi.

Tre regole della documentazione Shopify stabiliscono cosa fa una sovrascrittura:

Cosa c’è nel tuo file	Cosa succede al prodotto online
Colonna presente, cella compilata	Il valore viene sostituito dalla cella
Colonna presente, cella vuota	Il valore viene sovrascritto e lasciato vuoto
Colonna assente dal file	Il valore resta invariato

C’è una quarta regola, meno ovvia: se includi una colonna che dipende da altre colonne assenti dal file, i dati esistenti possono essere eliminati. Shopify cita l’esempio di colonne delle varianti come lo SKU senza le relative colonne delle opzioni.

Altri due vincoli prima di iniziare: il file non può superare i 15 MB, e un’importazione di prodotti non si può annullare una volta avviata.

Le colonne che contano per un aggiornamento SEO

Per aggiornare i campi SEO ti servono pochissime colonne (le intestazioni del modello Shopify restano in inglese):

• URL handle: la chiave di corrispondenza (chiamata Handle nei file più vecchi). Non modificarla mai in questo file.
• Title: obbligatoria negli aggiornamenti. Mantieni il valore esportato così com’è.
• SEO title: il titolo della pagina mostrato nei risultati. La documentazione CSV di Shopify ammette fino a 70 caratteri.
• SEO description: la meta description. Fino a 320 caratteri.

Tutto il resto (descrizione, fornitore, tag, colonne di varianti, prezzi e immagini) si può eliminare dal file. Visto che le colonne assenti restano intatte, un file a quattro colonne è l’importazione SEO più sicura possibile: materialmente non può svuotare un prezzo né staccare un’immagine.

Una nota sulle celle SEO vuote. Svuotare il titolo SEO non lascia il prodotto senza titolo nei risultati: Shopify ripiega su titolo e descrizione del prodotto. Ma il risultato è uno snippet costruito con un testo scritto per la scheda prodotto, che raramente è ciò che volevi. Tratta ogni cella SEO vuota come una scelta, non come una dimenticanza.

Una nota sugli handle. Dato che l’handle è la chiave di corrispondenza, non puoi rinominare l’URL di un prodotto tramite l’importazione modificando la colonna URL handle: la riga smette di corrispondere al prodotto originale. Cambia gli handle nel pannello di controllo, dove puoi creare un reindirizzamento dal vecchio URL.

Excel, codifica e altri modi di rovinare un file

La maggior parte dei disastri con i CSV avviene nel foglio di calcolo, non in Shopify.

• Codifica. Shopify richiede UTF-8 per evitare caratteri inattesi. In Excel salva come «CSV UTF-8 (delimitato da virgole)», non come semplice «CSV», altrimenti gli accenti di «Più» o «Caffè» diventano simboli illeggibili in tutto il catalogo.
• Separatori. Il centro assistenza Shopify chiede di controllare le impostazioni di esportazione di Excel perché i valori siano separati da virgole. Con le impostazioni regionali italiane, Excel usa spesso il punto e virgola come predefinito.
• Ordinamento. Shopify avverte che ordinare il file in un foglio di calcolo può rompere il collegamento tra prodotti e immagini. Se ordini per lavorare più comodamente, non importare quel file ordinato con le colonne delle immagini.
• Formule. Un =CONCATENA(...) usato per comporre le meta description va convertito in valori prima dell’esportazione.
• Intestazioni. Devono corrispondere esattamente al modello Shopify: non rinominarle e non tradurle.

Una procedura sicura per 500 prodotti

Immagina di avere un negozio con 500 prodotti e di volere nuove meta description su tutti. Ecco l’ordine delle operazioni che limita i danni possibili.

1. Esporta tutti i prodotti in CSV come backup e non toccarlo
2. Duplica l’esportazione come file di lavoro
3. Tieni solo URL handle, Title, SEO title, SEO description
4. Scrivi o incolla i nuovi testi SEO
5. Controlla le lunghezze e cerca celle SEO vuote
6. Salva come CSV UTF-8 con virgole
7. Importa prima 5 righe, con sovrascrittura selezionata
8. Apri quei 5 prodotti e confrontali con il backup
9. Importa le righe restanti
10. Esporta di nuovo e confronta con il backup

Il passo 10 è quello che quasi tutti saltano. Un semplice confronto nel foglio di calcolo (o un diff da terminale sulle due esportazioni ordinate) mostra ogni campo modificato. Se qualcosa si è spostato fuori dalle colonne SEO lo sai subito, e il backup è il file da cui ripristinare.

Quando l’editor in blocco è lo strumento migliore

Per qualche decina di prodotti, l’editor in blocco di Shopify può essere più semplice di un andata e ritorno via CSV. Seleziona i prodotti nell’elenco Prodotti, clicca su Modifica in blocco e usa Colonne per aggiungere le proprietà da modificare; anche i metafield si possono modificare lì. Verifica che i campi che ti servono siano disponibili come colonne nel tuo pannello. L’editor in blocco lavora dentro il pannello di controllo, quindi non ci sono codifiche o separatori da sbagliare, ma non ti offre alcun confronto prima/dopo oltre alla tua memoria.

Oltre il centinaio di righe, o quando i nuovi testi arrivano da un’agenzia, da un copywriter o da uno strumento IA in un foglio di calcolo, la strada del CSV è di solito più rapida. Richiede solo i controlli descritti sopra.

Mandare il CSV in revisione invece che direttamente online

La procedura sopra ha un punto debole: il passo 9 pubblica 495 modifiche in un colpo solo, e la revisione arriva dopo, se arriva. Per testi SEO scritti da altri (freelance, agenzia, strumento IA), preferisci leggere le modifiche prima che vadano online.

L’importazione CSV di Vetta è pensata per questo caso. Associ una volta sola le colonne del foglio ai campi (titolo SEO, meta description, tag, metafield e campi tradotti con una colonna per lingua), e la mappatura viene salvata per l’importazione successiva. Prima di partire, l’importazione mostra una stima di quante versioni creerà e del loro costo. Ogni riga diventa poi una versione proposta, non una modifica online: i revisori vedono un confronto campo per campo tra versione online e proposta, parola per parola, e approvano, chiedono modifiche o rifiutano ciascuna. Nulla arriva nel negozio senza approvazione.

Poiché ogni versione viene conservata, comprese le modifiche fatte direttamente nel pannello di controllo Shopify, annullare un lotto sbagliato significa ripristinare le versioni precedenti, non cercare l’esportazione del mese scorso. I crediti vengono scalati per versione approvata e pubblicata, come spiega la pagina dei prezzi.

Qualunque strada tu scelga, la regola non cambia: un file ridotto al minimo, un backup, una prova su poche righe e un confronto prima di fidarti dell’importazione.