Come si risolve «URL handle non valido»?

Usa solo lettere minuscole, numeri e trattini.

ShopifyVariantiBlocco importazioneCorrezione automatica

URL handle non valido

URL handle contiene caratteri che Shopify potrebbe rifiutare.

Di che problema si tratta?

URL handle contiene caratteri che Shopify potrebbe rifiutare.

Campo interessato:Handle

Blocco importazione: il tuo file non potrà essere importato finché questo non viene risolto.

Questo problema si corregge automaticamente: carica il CSV per risolverlo subito.

Correggi ora

Perché Shopify lo rifiuta

Handle non validi possono causare errori di importazione e URL dei prodotti non funzionanti.

Nota specifica per Shopify

Shopify raggruppa le righe delle varianti in base al valore della colonna Handle. Tutte le righe con lo stesso Handle appartengono allo stesso prodotto. Le colonne delle opzioni (Option1 Name, Option1 Value, ecc.) devono essere coerenti in ogni riga di variante del gruppo.

Esempi

Valore errato	Valore corretto	Nota
`Option2 compilata ma Option1 vuota`	`Prima Option1, poi Option2`
`La riga della variante compare prima della riga principale`	`La riga principale compare subito sopra le righe delle varianti`

Correggi in StriveFormats

Questo problema si corregge automaticamente. Carica il tuo CSV e fai clic su «Correggi i problemi» per applicare in una volta tutte le correzioni sicure.

Auto-correggibile: questo problema viene corretto automaticamente quando fai clic su Correggi problemi.

Apri il correttore CSV Vedi modello Guida al correttore Shopify

Correggi in Excel

1In Excel, ordina le righe per la colonna dell'identificativo principale (Handle per Shopify, SKU principale per WooCommerce).
2Verifica che nel risultato ordinato la riga principale compaia prima di tutte le sue righe di variante.
3Per WooCommerce: le righe principali devono avere Type = 'variable'. Le righe di variazione devono avere Type = 'variation' e la colonna Parent con lo SKU del prodotto principale.
4Per Shopify: tutte le righe di un gruppo di prodotto devono avere lo stesso Handle. Verifica che Option1 Name sia compilata prima di Option2 Name.
5Salva come «CSV (delimitato dal separatore di elenco)».

Correggi in Fogli Google

1In Fogli Google, vai su Dati > Ordina intervallo e ordina per la colonna dell'identificativo principale (Handle o SKU principale).
2Verifica che le righe principali compaiano subito prima delle loro righe di variante.
3Per WooCommerce: le righe principali richiedono Type = 'variable'. Le righe di variazione richiedono Type = 'variation' e Parent = lo SKU principale.
4Per Shopify: tutte le righe di variante di un gruppo di prodotto devono avere lo stesso Handle.
5Vai su File > Scarica > Valori separati da virgola (.csv).

Evitalo la prossima volta

✓Tieni sempre le righe del prodotto principale subito sopra tutte le sue righe di variante.
✓Per Shopify: usa lo stesso Handle in tutte le righe di un gruppo di prodotto.
✓Per WooCommerce: le righe principali hanno Type = variable; le righe figlie hanno Type = variation con Parent = SKU principale.
✓Fai una prova con un solo prodotto (uno principale e due o tre varianti) prima di importare l'intero catalogo.

Come StriveFormats lo rileva

StriveFormats raggruppa le righe in base all'identificativo principale (Handle per Shopify) e verifica che la struttura corrisponda al modello di varianti della piattaforma. Righe di variazione orfane, righe principali mancanti e combinazioni di opzioni duplicate vengono segnalate separatamente.

►Dettaglio tecnico

Shopify raggruppa le righe di prodotto in base al valore della colonna Handle. Tutte le righe con lo stesso Handle sono trattate come varianti dello stesso prodotto. La prima riga del gruppo deve contenere i campi del prodotto (Title, Body, Vendor). Le righe successive con lo stesso Handle richiedono solo i campi della variante (valori delle opzioni, Price, SKU). Se le colonne delle opzioni non sono coerenti all'interno di un gruppo (ad esempio se Option1 Name cambia tra le righe delle varianti), Shopify crea varianti duplicate o difettose, oppure rifiuta l'importazione.