Un cliente ha personalizzato un prodotto ma non si aggiunge al carrello. Questa guida ti accompagna tra le cause abituali, nell’ordine in cui conviene controllarle, così trovi quella che riguarda il tuo prodotto. È scritta per i commercianti che risolvono problemi sul proprio negozio.
Parti dai campi e dalle scelte obbligatori, dalla disponibilità della variante e dall’errore esatto mostrato. Composerie può anche bloccare il passaggio prima che Shopify riceva una richiesta di carrello, per esempio quando la personalizzazione o un’immagine elaborata non è stata accettata.
Se ciò che manca è il pulsante Aggiungi al carrello o Acquista ora del tema, e non il customizer, è voluto. Vedi perché Acquista ora scompare.
Controlla prima le cause più ovvie
Parti dalle cose che puoi confermare in pochi secondi sul prodotto stesso. Apri il prodotto come lo aprirebbe un cliente e prova ad aggiungerlo. Il messaggio che vedi di solito indica direttamente la causa.
Compila ogni campo obbligatorio
Se un campo di personalizzazione è obbligatorio e il cliente lo lascia vuoto, il customizer non gli permette di continuare. Indica il campo, in rosso, sopra il campo stesso: “Compila: Titolo”. Compila quel campo, poi continua.
In un customizer a passaggi il rifiuto arriva presto, al confine del passaggio, prima che venga inviato qualsiasi dato. In uno a pagina singola arriva invece all’aggiunta al carrello, con la formulazione “Completa” seguita dal nome del campo.
Per controllare quali campi sono obbligatori, vedi rendere i campi modificabili dal cliente.

Controlla che la variante sia disponibile
Se una variante è esaurita, il customizer segna quell’opzione come “Esaurito” e la disattiva. Un’opzione disattivata non si può selezionare, quindi l’aggiunta non va a buon fine per quella combinazione. Scegli un’opzione disponibile oppure rifornisci la variante in Shopify.
Controlla la variante sia nella pubblicazione di Composerie sia in Shopify. Un’opzione selezionabile da sola non dimostra che Shopify la accetterà al checkout. Per come le varianti arrivano al checkout, vedi varianti, opzioni e add-on.

Cerca un pulsante Personalizza al posto di Aggiungi al carrello
Per Pagina intera, controlla che una voce Personalizza funzionante apra il customizer previsto e che il suo passaggio al carrello funzioni. L’assenza del pulsante Aggiungi al carrello da sola non stabilisce che il prodotto sia configurato correttamente. Vedi le modalità del negozio spiegate.
Riproducilo tu
Apri il prodotto esatto che dà problemi e percorrilo come farebbe un cliente. Vedere il messaggio reale nel suo contesto ti dice quale delle cause qui sopra si applica. Annota la formulazione, perché la sezione successiva la usa.
Leggi il messaggio che restituisce Shopify
Quando la richiesta di aggiunta raggiunge Shopify e Shopify la rifiuta, il customizer non fallisce in silenzio. Mostra il testo di errore che Shopify stesso restituisce, così il cliente (e tu) può vedere cosa è andato storto. Il pulsante passa a uno stato “Impossibile aggiungere, riprova”, e il messaggio sottostante descrive il motivo.
Questo testo viene dalle regole di checkout di Shopify. I motivi comuni includono una variante non disponibile, un limite di quantità (un minimo o un massimo per ordine) o una variante esaurita che Shopify non permette di vendere. Poiché la regola sta in Shopify, la soluzione di solito è nelle impostazioni di inventario o di vendita del prodotto, non in Composerie.
Copia il testo esatto che vedi e confrontalo con messaggi di errore spiegati. Quell’articolo collega i messaggi più comuni alla loro causa e alla soluzione.
Escludi un tema che blocca l’aggiunta
Il percorso del carrello dipende dalla modalità del negozio e dai controlli in uso. Il customizer del cliente salva e convalida la personalizzazione prima del suo passaggio al carrello Shopify. L’integrazione del tema deve anche preservare le proprietà della riga d’ordine richieste; controllare solo il pulsante nativo del tema non è un test completo.
Se un tema personalizzato o un’altra app sostituisce il flusso di aggiunta, controlla se le proprietà di personalizzazione sopravvivono. In quel caso il prodotto può comunque aggiungersi al carrello, ma i dettagli di personalizzazione vengono persi dalla riga.
Per verificare se la causa è il tema, prova lo stesso prodotto su un tema Shopify predefinito pulito (per esempio Dawn). Se la personalizzazione arriva sul tema predefinito ma non sul tuo, il conflitto è nel tuo tema o in un’altra app installata.
Per il dettaglio tecnico di come funziona questo collegamento, vedi come funziona l’intercettore del carrello. Per verificare che le varianti corrispondano a Shopify al checkout, vedi sincronizzazione delle varianti e checkout.
Domande frequenti
Il pulsante Aggiungi al carrello non fa niente. Cosa non va?
Controlla i campi e le scelte obbligatori, lo stato di elaborazione delle immagini, la variante selezionata e il messaggio di errore. Se il pulsante manca, controlla la modalità di visualizzazione e se è presente una voce Personalizza funzionante.
Su questo prodotto non c'è nessun pulsante Aggiungi al carrello.
Controlla la modalità di pubblicazione. Per Pagina intera, una voce Personalizza funzionante deve portare alla personalizzazione e al passaggio al carrello. Se anche quella voce manca o non funziona, segui la checklist sul posizionamento nel tema.
Il prodotto si aggiunge ma nell'ordine manca la personalizzazione.
Un'altra app o un tema personalizzato può sostituire la richiesta di aggiunta, perdendo le proprietà di personalizzazione. Prova lo stesso prodotto su un tema predefinito per confermarlo.
Se hai percorso tutte e tre le cause e il prodotto continua a non aggiungersi, contatta il supporto con il link al prodotto e il messaggio esatto che vedi.
Passo successivo
Tieni a portata di mano messaggi di errore spiegati per tradurre ogni messaggio di Shopify nella sua soluzione.