Nel checkout classico ogni campo ha una priorità che ne decide la posizione: nome 10, cognome 20, azienda 30, paese 40, indirizzo 50 e 60, città 70, provincia 80, CAP 90, telefono 100, email 110. Per spostare email e telefono si usa woocommerce_checkout_fields. Per i campi dell’indirizzo invece serve woocommerce_default_address_fields, altrimenti le regole del paese rimettono tutto com’era. Nel checkout a blocchi l’ordine è già pensato, con l’email in cima.
L’ordine dei campi conta più di quanto sembri: un checkout che chiede le cose nell’ordine in cui il cliente le pensa si compila più in fretta e si abbandona meno. Nel 2019 avevo pubblicato come spostare l’email in cima ai dati di fatturazione. Il metodo funziona per alcuni campi, ma per quelli dell’indirizzo serve un filtro diverso.
Come funziona l’ordine dei campi?
Nel checkout classico i campi sono divisi in quattro gruppi: billing per la fatturazione, shipping per la spedizione, account per la creazione dell’account e order per le note. Ogni campo ha un numero di priorità: più è basso, più il campo sta in alto. I valori predefiniti sono 10 per il nome, 20 per il cognome, 30 per l’azienda, 40 per il paese, 50 e 60 per le due righe dell’indirizzo, 70 per la città, 80 per la provincia, 90 per il CAP, 100 per il telefono e 110 per l’email. I campi di spedizione seguono la stessa sequenza, senza telefono ed email.
Come sposto l’email in cima?

Email e telefono non fanno parte dell’indirizzo, quindi si spostano con il filtro dei campi del checkout. Il codice va in un piccolo plugin, come spiego in come creare un plugin:
|
1 2 3 4 5 6 |
<?php // porto l'email in cima ai dati di fatturazione add_filter( 'woocommerce_checkout_fields', function ( $fields ) { $fields['billing']['billing_email']['priority'] = 5; return $fields; } ); |
Con 5 l’email finisce prima del nome, che ha 10. Nel 2019 usavo 4: qualsiasi numero sotto 10 va bene. Mettere l’email per prima ha anche un vantaggio pratico: se il cliente abbandona il checkout, molti plugin di recupero carrello hanno già l’indirizzo a cui scrivere.
Perché i campi dell’indirizzo tornano al loro posto?
Perché WooCommerce adatta l’indirizzo al paese scelto: in Italia, per esempio, c’è la provincia, in altri paesi no, e l’ordine cambia. Quando il cliente seleziona il paese, uno script riordina i campi dell’indirizzo secondo le regole di quel paese, ignorando le priorità impostate nel filtro del checkout. Per spostarli davvero si interviene sui campi predefiniti dell’indirizzo:
|
1 2 3 4 5 |
// CAP prima della città, per tutti i paesi add_filter( 'woocommerce_default_address_fields', function ( $campi ) { $campi['postcode']['priority'] = 65; return $campi; } ); |
Qui le chiavi sono senza prefisso, postcode e non billing_postcode, perché valgono sia per la fatturazione sia per la spedizione. Se un paese ha regole proprie, si regolano con il filtro woocommerce_get_country_locale.
E per i campi che ho aggiunto io?
Basta dare una priorità tra quelle esistenti: un campo con 35 finisce tra azienda e paese, uno con 105 tra telefono ed email. Come aggiungere campi al checkout, codice fiscale compreso, lo spiego in come personalizzare i campi del checkout.
E nel checkout a blocchi?
Il checkout a blocchi, predefinito dalla versione 8.3, ha già un ordine diverso: l’email sta nella sezione dei contatti, in cima, prima dell’indirizzo. Questi filtri PHP lì non vengono usati. Le sezioni si spostano nell’editor, trascinando i blocchi del checkout, e i campi aggiunti con le Additional Checkout Fields API compaiono nella sezione che scegli. Se il tuo negozio usa ancora il checkout classico, valuta il passaggio: l’ordine dei campi è uno dei vantaggi già pronti. Per un checkout su misura, puoi contare su un programmatore WooCommerce.
In sintesi
Le priorità predefinite vanno da 10 (nome) a 110 (email). Sposta email e telefono con woocommerce_checkout_fields, i campi dell’indirizzo con woocommerce_default_address_fields (chiavi senza prefisso), e i casi per paese con woocommerce_get_country_locale. I campi aggiunti prendono una priorità tra quelle esistenti. Nel checkout a blocchi l’ordine si gestisce nell’editor.
Domande frequenti
Come cambio l’ordine dei campi nel checkout di WooCommerce?
Modificando la priority dei campi con woocommerce_checkout_fields o, per l’indirizzo, con woocommerce_default_address_fields.
Perché il CAP torna al suo posto dopo che l’ho spostato?
Perché le regole del paese riordinano l’indirizzo: va spostato con woocommerce_default_address_fields.
Qual è la priorità predefinita dell’email nel checkout?
110, l’ultima dei dati di fatturazione; con un valore sotto 10 va in cima.
Questi filtri funzionano con il checkout a blocchi?
No, nel checkout a blocchi l’ordine si gestisce dall’editor e l’email è già in cima.