Redirect 301 su Shopify: la mappa in cinque passi e il template CSV

I redirect 301 su Shopify mandano visitatori e Google da un vecchio URL al nuovo indirizzo, e in una migrazione se ne caricano centinaia in una volta da un CSV con due colonne: Redirect from e Redirect to. Il file si importa in minuti. Il lavoro vero è la mappa che c’è dietro. Questa guida ti dà i cinque passi che usiamo per costruirla, i limiti che Shopify impone, i controlli da fare dopo il go-live e un template CSV gratuito nel formato di importazione di Shopify.

Siamo noprob agency. Nello Shopify Launch Sprint la mappa dei redirect 1:1 viene collaudata in automatico prima e dopo il go-live, quindi questo è un processo che eseguiamo, non una teoria. La nostra checklist SEO per la migrazione dice cosa controllare in tutto il passaggio; questo articolo è il processo per produrre l’unico documento da cui quella checklist dipende. Per il percorso completo di una migrazione leggi la guida alla migrazione a Shopify.

Cosa fa un redirect 301 su Shopify e che aspetto ha il CSV?

Un 301 è un redirect permanente: dice a browser e motori di ricerca che una pagina si è spostata per sempre e dove si trova ora. La guida di Google sugli spostamenti di sito con cambio di URL consiglia redirect permanenti lato server e chiede di decidere una destinazione per ogni vecchio URL. La pagina di aiuto di Shopify nomina i 301 quando avverte che browser e motori di ricerca li tengono in cache, cosa che conta quando collaudi.

Il file di importazione di Shopify è un CSV con due intestazioni, Redirect from e Redirect to, e un redirect per riga. Il file di esempio di Shopify, collegato dalla sua pagina di aiuto sui redirect URL, ha esattamente quelle due intestazioni e una riga d’esempio che manda /example_product.php su /products/example-product. Gli esempi della pagina usano percorsi che iniziano con la barra, e la pagina dice di usare un URL relativo per il dominio principale e un URL completo solo per le destinazioni esterne.

Il template ha 14 righe d’esempio con gli schemi tipici di WooCommerce, Magento e PrestaShop: prodotti, categorie, pagine, un articolo del blog, un marchio e un URL con parametri. Sostituisci gli esempi con le tue righe e lascia intatte le due intestazioni. Tutto il resto che devi tracciare sta in un foglio di lavoro a parte, da cui esporti solo due colonne:

• Vecchio URL e nuovo URL: le due colonne che diventano il file di importazione.
• Tipo di pagina: prodotto, categoria, pagina, articolo, marchio, altro.
• Fonte: dove hai trovato l’URL (sitemap, Search Console, crawl, backlink, archivio).
• Traffico o link: perché la riga conta, così sai dove guardare due volte.
• Decisione: tieni, unisci o ritira.
• Controllato: la data e chi ha controllato.

Come si costruisce la mappa dei redirect in cinque passi?

La mappa si costruisce in cinque passi: raccogli tutti i vecchi URL, abbina ciascuno a un nuovo URL, decidi i casi senza equivalente, importa il file e collauda dopo il go-live. L’ordine conta perché ogni passo alimenta il successivo, e il primo decide quanto può essere completo il risultato.

Passo 1: raccogli tutti i vecchi URL, non solo quelli della sitemap

La sitemap mostra ciò che il vecchio store voleva far vedere a Google; Google ricorda di più. Quindi si combinano le fonti, si tolgono i doppioni e si tiene la fonte in una colonna.

• Tutte le vecchie sitemap: prodotti, categorie, pagine e articoli.
• Search Console: l’esportazione delle prestazioni per ogni URL che ha ancora impressioni o clic, e il report Pagine per ciò che Google ha indicizzato.
• Un crawl del vecchio sito, che mostra anche i link interni e i redirect già presenti.
• Un’esportazione dei backlink: le pagine a cui altri siti linkano sono quelle che non puoi permetterti di perdere.
• Copie archiviate del vecchio sito, per gli URL spariti prima della migrazione ma che raccolgono ancora link.
• Le pagine di destinazione nelle analytics dell’ultimo anno.

La mia regola: raccogli finché il vecchio store è ancora online. Quando il dominio resta lo stesso, a store nuovo online non c’è più niente da scansionare.

Passo 2: abbina ogni vecchio URL a uno nuovo, per tipo di pagina

Abbina per tipo di pagina, perché ogni tipo ha la sua regola: prodotti ai prodotti, categorie alle collezioni, pagine alle pagine e articoli agli articoli del blog. Gli schemi si fanno in un foglio di calcolo, le eccezioni a mano. Questi sono gli schemi che incontriamo più spesso, da verificare sempre sulle tue impostazioni, perché ogni piattaforma permette di cambiarli:

• WooCommerce. /product/camicia-blu-cotone va su /products/camicia-blu-cotone e /product-category/camicie su /collections/camicie. Quelle due basi, product e product-category, sono i valori predefiniti nel codice sorgente di WooCommerce, ma uno store può cambiarle. Gli articoli stanno alla radice del dominio (o sotto una data) e vanno su /blogs/news/. Di più in da WooCommerce a Shopify.
• Magento. /camicia-blu-cotone.html va su /products/camicia-blu-cotone, e così lo stesso prodotto con il percorso di categoria come /uomo/camicie/camicia-blu-cotone-cotone.html. Le categorie come /uomo/camicie.html vanno su una collezione. Il suffisso è configurabile, e i percorsi di sistema come /catalog/product/view/id/34 hanno una riga solo se Search Console mostra impressioni. Di più in da Magento a Shopify.
• PrestaShop. Lo schema predefinito del prodotto è {category:/}{id}-{rewrite}.html, quindi /camicie/7-camicia-blu-cotone.html va su /products/camicia-blu-cotone; le categorie (/12-camicie) vanno alle collezioni, le pagine CMS (/content/4-spedizioni) a /pages/, i marchi (/brand/3-acme) a una collezione per fornitore. Gli schemi sono nel Dispatcher.php di PrestaShop. L’ID nell’indirizzo è una chiave affidabile per il collegamento. Di più in da PrestaShop a Shopify.

Tieni lo slug identico dove puoi: così l’abbinamento è meccanico. Quando lo slug cambia (prodotti rinominati, handle tradotti), collega con ID prodotto o SKU dalle due esportazioni di catalogo invece di indovinare dal nome. Più vecchi URL possono avere la stessa destinazione: le varianti e le versioni con percorso di categoria dello stesso prodotto finiscono tutte su un’unica pagina /products/.

Punta ogni riga all’URL finale. Se /a già reindirizzava a /b sulla vecchia piattaforma, /a va diretto al nuovo /b. Google chiede di evitare le catene e, dove non si può, di non superare tre passaggi e di restare sempre sotto i cinque. Su uno store nuovo puoi puntare a uno.

Passo 3: decidi i casi senza equivalente

Quando una vecchia pagina non ha un gemello sul nuovo store, mandala alla pagina più vicina che serve lo stesso visitatore, e se non esiste lascia che risponda 404. Google avverte che mandare molti vecchi URL a un’unica destinazione non pertinente, come la home page, può confondere gli utenti e può essere trattato come soft 404. Queste sono le scelte che ti consiglio:

• Prodotto fuori produzione: la collezione in cui stava, o un sostituto solo se risponde allo stesso bisogno.
• Due categorie unite: la collezione che resta.
• Pagine di tag, filtri, paginazione, autore e allegati: la collezione più vicina se hanno link o traffico, altrimenti nessuna riga.
• Vecchie pagine di campagna: la pagina che oggi porta l’offerta, oppure nessuna riga.
• Pagine che ritiri apposta: nessuna riga. Un 404 è una risposta onesta, e scrivere "ritira" nella colonna Decisione lo tiene una decisione e non una dimenticanza.

Passo 4: importa il file in Shopify

In Shopify i redirect si importano in Content > Menus > View URL Redirects: clicca Import, aggiungi il file CSV, caricalo, controlla l’importazione e clicca Import redirects. (I nomi sono quelli dell’admin in inglese.) Fallo prima che il dominio si sposti: la guida di Shopify per migrare da WooCommerce consiglia di impostare i redirect prima di trasferire il dominio. Shopify ammette fino a 100.000 redirect, o 20.000.000 su Plus.

Prima di cliccare, fai questi quattro controlli sul file:

• Nessuna collisione. Nessun percorso Redirect from carica una pagina viva sul nuovo store, perché Shopify lo ignora.
• Ogni riga è completa. Ci sono entrambi i valori, l’origine inizia con la barra e non ha dominio, e nessuna origine compare due volte.
• Nessun percorso riservato. Nessuna origine rientra nell’elenco della sezione successiva.
• Ogni destinazione è vera. Ogni Redirect to è una pagina che oggi risponde 200, non un altro redirect e non un refuso.

Per carichi grandi o ripetuti c’è anche l’API Admin GraphQL: l’oggetto UrlRedirectImport riporta quante righe sono state create, aggiornate e fallite, e ti dà un numero da confrontare con il tuo file. Dopo l’importazione, esporta i redirect come CSV dalla stessa schermata: quel file è la traccia di ciò che è andato online.

Passo 5: controlla dopo il go-live

Dopo il go-live collaudi ogni vecchio URL, non un campione, e poi guardi Search Console per ciò che la mappa ha mancato. La guida di Google suggerisce lo strumento Controllo URL per i singoli URL e script o strumenti da riga di comando per gli elenchi grandi. Quattro controlli:

• Fai girare tutto l’elenco. Ogni vecchio URL della mappa deve rispondere con un solo 301 e poi 200 sulla nuova pagina. Riscrivi nel foglio le righe che falliscono. Prova anche la versione con e senza barra finale: gli indirizzi di WooCommerce ne hanno una.
• Apri a mano le pagine principali. Gli URL con più traffico e backlink, in una finestra privata, così un redirect in cache non ti inganna.
• Guarda Search Console. Invia la nuova sitemap e segui il report Pagine: i nuovi URL "non trovato" con impressioni sono righe che hai mancato.
• Torna. Porta i nuovi 404 nella mappa dopo due settimane e di nuovo a 90 giorni, e tieni i redirect: Google dice in genere almeno un anno.

Cosa non può reindirizzare Shopify?

Shopify reindirizza solo da URL che restituiscono 404, e una manciata di percorsi e schemi è vietata, quindi decidi quelle righe prima del lancio. Tutto questo viene dalla pagina di aiuto di Shopify sui redirect URL:

• Una pagina viva vince. La pagina dice che si può reindirizzare solo da URL rotti. Se il vecchio percorso ora carica una pagina valida, il redirect non fa nulla: è il controllo delle collisioni del passo 4.
• Percorsi fissi: /products, /collections e /collections/all non si possono reindirizzare.
• Prefissi riservati: gli URL che iniziano con /apps, /application, /cart, /carts, /orders, /services e /shop. Questo colpisce forte WooCommerce: il carrello e la pagina negozio stanno su quei percorsi. La pagina descrive /shop in modo diverso in due punti, quindi collauda la tua riga. Se non funziona, trattala come un caso senza equivalente: punta i menu e i link che controlli a /collections/all.
• Filtri per tag delle collezioni: gli URL come /collections/nome/tag non si possono reindirizzare, anche se nessun prodotto ha quel tag.
• Indirizzi .html: un URL .html non si può reindirizzare allo stesso indirizzo senza .html. Non impedisce a /camicia-blu-cotone.html di andare su /products/camicia-blu-cotone.
• Query string: Shopify dice che potrebbero non funzionare come previsto. Considera a rischio gli URL con parametri come /index.php?controller=category&id_category=12: il nostro template ne ha uno per provare come si comporta il tuo store, e se fallisce togli quella riga.
• Sottocartelle di lingua e mercato: la pagina dice che i redirect valgono per tutte e, nelle limitazioni, che non è così. Prova un redirect in ogni sottocartella prima di fidarti.
• Cache: browser e motori di ricerca tengono in cache i 301, quindi un redirect sbagliato non sparisce quando lo cancelli. Collauda prima che il dominio si sposti.

Come accelera la mappa un agente AI, e perché serve una revisione separata?

Un agente AI accelera l’abbinamento del passo 2, la parte lenta nel mezzo della mappa, ma deve proporre le righe e mai approvarle: uno script e una revisione separata decidono cosa si importa. In noprob agency lavoriamo ogni giorno con agenti costruiti su Claude Code (lo sviluppo con agenti AI è uno dei superpoteri del nostro Custom AI System), e questa è la divisione che ti consiglio per le mappe dei redirect.

• Prima le regole, senza AI. Uno script gestisce gli schemi puliti per slug. Copre la maggior parte del file ed è deterministico.
• L’agente prende ciò che resta. Per ogni URL rimasto riceve la vecchia pagina (titolo, H1, breadcrumb) e un elenco chiuso di nuovi URL validi dall’esportazione del catalogo. Deve scegliere da quell’elenco, dare un motivo in una riga o rispondere "nessun equivalente". Un elenco chiuso è ciò che gli impedisce di inventare indirizzi.
• Gli script controllano l’output. Ogni destinazione esiste e risponde 200, nessuna catena, nessuna origine doppia, nessun percorso riservato.
• Un revisore separato. Un secondo passaggio, in un contesto nuovo, vede solo la vecchia pagina e la destinazione proposta, con criteri scritti: stessa intenzione, stesso prodotto e non solo uno simile, una collezione e mai la home page. Non vede il ragionamento del primo agente. Le righe che segnala vanno a una persona.
• Una persona firma. Ogni URL con traffico o backlink passa sotto occhi umani, più una fetta casuale del resto.

Perché separata? Chi ha scritto una riga tende a ripetere la propria logica quando la rilegge, e vale per un modello come per una persona. È l’indipendenza che trova gli errori. Lo stesso metodo, applicato a tutta la migrazione, è in Migrare a Shopify con gli agenti AI. Se vuoi costruire agenti come questi per il tuo team, è il lavoro dell’AI Accelerator.

Come è andata in una migrazione vera?

Su Nazzi, uno store WooCommerce, abbiamo controllato 215 URL archiviati sul nuovo store dopo il go-live e consegnato il CSV dei redirect 301, pronto da importare in Shopify (caso studio). La lezione è quella del passo 5: la mappa non è finita quando il file è importato. Collaudare i vecchi indirizzi uno per uno è un lavoro separato dal costruire la mappa, ed è ciò che trasforma un elenco di redirect in un risultato di cui fidarsi.

Domande frequenti

A cosa serve un redirect 301 su Shopify?

Un redirect 301 è un reindirizzamento permanente: manda visitatori e motori di ricerca da un vecchio URL a uno nuovo e dice che lo spostamento è definitivo. Google consiglia redirect permanenti lato server quando gli URL cambiano, con una destinazione per ogni vecchio URL. In Shopify si creano in Content > Menus > View URL Redirects.

Come importo i redirect 301 su Shopify con un CSV?

Prepara un CSV con le intestazioni Redirect from e Redirect to e un redirect per riga. Poi apri View URL Redirects, clicca Import, aggiungi il file, caricalo, controlla l’importazione e clicca Import redirects. Il nostro template gratuito è già in questo formato.

Perché i miei redirect su Shopify non funzionano?

La causa più comune è che il vecchio URL carica ancora una pagina valida: Shopify reindirizza solo da URL rotti. Le altre sono un percorso riservato come /cart o /shop, un percorso fisso come /collections, una query string nell’URL di partenza o un browser che ha in cache un 301 precedente. Prova in una finestra privata e controlla la riga per questi casi.

Shopify può reindirizzare /collections, /products o /shop?

No. La pagina di aiuto di Shopify dice che non si possono reindirizzare i percorsi fissi /products, /collections e /collections/all, né gli URL che iniziano con prefissi come /apps, /cart, /orders, /services e /shop. La pagina negozio di WooCommerce su /shop è il caso tipico: decidi come gestirla prima del lancio.

Per quanto tempo vanno tenuti i redirect 301?

La guida di Google dice di tenerli il più a lungo possibile, in genere almeno un anno. Dal punto di vista del visitatore si possono tenere per sempre, quindi il mio consiglio è di non cancellare mai un redirect che riceve ancora clic.

Un agente AI può costruire la mappa dei redirect?

Può proporre la maggior parte delle righe, soprattutto quelle ambigue, ma non deve approvarle. Regole e script gestiscono gli schemi puliti, l’agente suggerisce le destinazioni da un elenco chiuso di URL veri, e una revisione separata più un campione controllato da una persona decidono cosa si importa.

Lo Shopify Launch Sprint porta il tuo store su Shopify in 14 giorni con il nostro Custom AI System: calendario fisso, prezzo pubblico e 4 garanzie scritte.

Antonio Manitta

Founder e eCommerce Manager di NoProb Agency

Da oltre 7 anni aiuto brand fashion, integratori e DTC a far crescere il loro eCommerce. Lavoro in long-term partnership con tre brand alla volta, costruendo sistemi stabili che si compongono nel tempo.

Scopri NoProb →