Cumulative Layout Shift (CLS): cosa misura e come migliorarlo
Il Cumulative Layout Shift misura quanto una pagina si sposta mentre le persone la usano. Stai per toccare un link, sopra si carica un annuncio e tocchi la cosa sbagliata. Il CLS lo trasforma in un numero, e Google lo vuole a 0,1 o meno. La maggior parte degli spostamenti di layout nasce da poche cause, e quasi tutte si risolvono nel template, una volta sola.
Che cos'è il Cumulative Layout Shift?
Il Cumulative Layout Shift (CLS) è la raffica più grande di spostamenti di layout imprevisti durante l'intera vita di una pagina. Uno spostamento di layout avviene quando un elemento visibile cambia posizione da un frame all'altro senza che il visitatore lo abbia chiesto. È uno dei tre Core Web Vitals, accanto a Largest Contentful Paint e Interaction to Next Paint.
A differenza degli altri due, il CLS non ha unità di misura. È un punteggio: 0 significa che non si è mosso nulla, e ogni spostamento lo fa salire in base a quanta parte dello schermo si è mossa e di quanto.
Le soglie del CLS in breve
| Valutazione | CLS al 75° percentile |
|---|---|
| ✓ Buono | ≤ 0,1 |
| ◐ Da migliorare | da 0,1 a 0,25 |
| – Scarso | > 0,25 |
Le soglie vengono da web.dev. Google legge il 75° percentile delle visite reali su 28 giorni, separatamente per smartphone e desktop. Un solo spostamento può bastare per non passare: l'esempio di web.dev, un elemento che copre metà del viewport e scende di un quarto, da solo vale 0,1875.
Perché conta oltre il punteggio: uno spostamento nel momento sbagliato fa toccare il link sbagliato, perdere il punto in un articolo o premere Acquista sul prodotto sbagliato. Gli spostamenti di layout sono anche il segno di un template che non conosce le proprie dimensioni, il che tende a causare altri problemi, come un LCP lento quando l'immagine hero viene dimensionata solo dopo il caricamento.
Come si calcola il punteggio CLS
Ogni spostamento riceve un punteggio:
punteggio dello spostamento = frazione d'impatto x frazione di distanza
La frazione d'impatto è la quota del viewport coperta dagli elementi che si muovono, prima e dopo lo spostamento messi insieme. La frazione di distanza è quanto si sono mossi, divisa per il lato più lungo del viewport. Gli spostamenti vengono poi raggruppati in finestre di sessione, e il CLS è la finestra con il totale più alto.
| Regola | Valore | Fonte |
|---|---|---|
| Pausa che chiude una finestra di sessione | 1 s | web.dev |
| Finestra di sessione più lunga | 5 s | web.dev |
| Spostamenti ignorati dopo un tocco o un tasto | entro 500 ms | web.dev |
| Lo scroll conta come input | – | web.dev |
| Spostamenti dopo il caricamento conteggiati | ✓ | web.dev |
Ne seguono due cose. Gli spostamenti causati dal visitatore, come aprire una fisarmonica, non contano se avvengono entro 500 ms dal tocco. E gli spostamenti dopo il caricamento della pagina, come un banner che entra durante lo scroll o una lista infinita che spinge giù il footer, contano, ed è per questo che il CLS sul campo è spesso peggiore del numero di laboratorio.
Cause comuni degli spostamenti di layout e come risolverle
| Causa | Correzione |
|---|---|
| Immagini senza width e height | Imposta entrambi, o aspect-ratio |
| Annunci, embed e iframe caricati tardi | Riserva il loro spazio |
| Contenuto inserito sopra altro contenuto | Inserisci sotto, o riserva lo spazio |
| Banner cookie o promo che spinge la pagina | Sovrapponilo, in posizione fissa |
| Web font che si sostituisce con metriche diverse | font-display, size-adjust |
| Animare top, left, width, height | Anima invece transform |
| CSS caricato tardi che cambia il layout | Carica prima il CSS del layout |
| Skeleton della dimensione sbagliata | Usa la dimensione finale |
Immagini e annunci sono le due cause principali. SEO ProCheck racconta come BuzzFeed le ha affrontate entrambe in Improving CLS at BuzzFeed, e come ha usato i dati degli utenti reali per trovare il resto.
Correggere gli spostamenti più comuni
Immagini e video: comunica al browser la dimensione
Con width e height nell'HTML, i browser moderni calcolano il rapporto d'aspetto e tengono lo spazio prima che arrivi il file, anche quando il CSS rende l'immagine responsive:
<img src="/img/product.webp" width="800" height="600" alt="Blue canvas sneaker, side view">
/* CSS: still responsive, space still held */
img { max-width: 100%; height: auto; }
Annunci ed embed: riserva uno slot
Dai al contenitore un'altezza minima pari alla dimensione di annuncio più comune per quello slot. Se l'annuncio non viene riempito, mantieni lo spazio invece di comprimerlo, o comprimilo solo sotto la prima schermata.
.ad-slot-top { min-height: 250px; }
Font: sostituzione senza riflusso
font-display: swap mostra subito il testo, in un font di riserva. Se il font di riserva è più largo o più alto, il testo si ridispone quando arriva il web font. Allinea le dimensioni del font di riserva con size-adjust e gli override delle metriche, oppure precarica il font così che di solito arrivi prima del primo paint. La guida di web.dev su come ottimizzare il CLS tratta ogni caso.
Animazioni: muovi con transform
Un'animazione che cambia top o margin sposta tutto ciò che ha intorno. Una che usa transform: translate() muove solo l'elemento e non viene mai contata come spostamento di layout.
Come trovare cosa si è spostato
| Strumento | Campo | Laboratorio | Indica l'elemento |
|---|---|---|---|
| PageSpeed Insights | ✓ | ✓ solo il caricamento | ✓ |
| Report Core Web Vitals di Search Console | ✓ | – | – |
| Pannello Performance di Chrome DevTools | – | ✓ | ✓ |
| Libreria web-vitals | ✓ | – | ✓ con attribution |
Un'esecuzione di Lighthouse vede solo il caricamento, su una sola dimensione di schermo, senza scroll e senza scelta sul consenso. Se il CLS sul campo è scarso e quello di laboratorio va bene, lo spostamento avviene quasi sempre dopo: dopo lo scroll, dopo una scelta sui cookie o su una dimensione di schermo che il test non ha usato. Registra una traccia in DevTools mentre scorri e clicchi, e guarda la traccia Layout shifts. La pagina di diagnosi CLS too high di SEO ProCheck elenca altri punti da controllare.
Testa ogni template una volta, invece di ogni pagina. Un template prodotto con immagini senza dimensioni si sposta su ogni prodotto. La guida al test di velocità delle pagine in blocco mostra come.
Trovare i problemi di spostamento del layout con Neova
Neova legge il CLS sul campo dal Chrome UX Report con la tua chiave API gratuita, per gruppo di pagine e con un andamento di 40 settimane. Durante un crawl trova anche le cause presenti nell'HTML di ogni pagina, e con Lighthouse attivo misura il CLS di laboratorio su una pagina HTML per gruppo di pagine. I controlli:

- Il CLS supera 0,1 nei dati di laboratorio o sul campo
- L'HTML supera i 2 MB o i Core Web Vitals non sono nella fascia buona
- Width e height dell'immagine non impostati, su ogni pagina scansionata, senza bisogno di Lighthouse
- Web font senza font-display swap o optional
- Animazioni non composite
- Immagine mostrata con il rapporto d'aspetto sbagliato, con il rendering JavaScript attivo
Ogni controllo gira su ogni piano, Free compreso, su
Domande
Qual è un buon punteggio di cumulative layout shift?
0,1 o meno al 75° percentile delle visite reali. Tra 0,1 e 0,25 è da migliorare, e sopra 0,25 è scarso.
Il CLS conta gli spostamenti dopo il caricamento della pagina?
Sì. Il CLS copre l'intera visita e riporta la raffica di spostamenti peggiore, una finestra di sessione fino a 5 secondi. Gli spostamenti entro 500 ms da un clic, un tocco o un tasto vengono esclusi, perché il visitatore se li aspettava.
Perché il mio CLS è 0 in Lighthouse ma scarso sul campo?
Lighthouse vede solo il caricamento su uno schermo, senza scroll né scelta sui cookie. I visitatori reali scorrono, accettano banner e usano altre dimensioni di schermo, ed è lì che avvengono gli spostamenti.
Le immagini hanno bisogno di width e height se il CSS ne imposta la dimensione?
Sì. Con width e height nell'HTML il browser conosce il rapporto d'aspetto prima che l'immagine si carichi e tiene lo spazio, mentre il CSS controlla comunque la dimensione mostrata.
Può esserci uno spostamento di layout senza che si muova alcun contenuto visibile?
No. Contano solo gli elementi visibili che cambiano posizione iniziale. Un elemento che compare senza spingere nient'altro non sposta il layout; uno che spinge giù altri contenuti sì.