Cumulative Layout Shift (CLS): o que mede e como corrigir
O Cumulative Layout Shift mede quanto uma página pula enquanto as pessoas a usam. Você vai tocar em um link, um anúncio carrega acima dele e você toca na coisa errada. O CLS transforma isso em um número, e o Google quer que ele fique em 0,1 ou menos. A maioria dos deslocamentos de layout vem de poucas causas, e quase todas são corrigidas no template, uma única vez.
O que é Cumulative Layout Shift?
Cumulative Layout Shift (CLS) é o maior surto de deslocamentos inesperados de layout durante toda a vida de uma página. Um deslocamento de layout acontece quando um elemento visível muda de posição de um quadro para o outro sem que o visitante tenha pedido. É uma das três Core Web Vitals, ao lado do Largest Contentful Paint e do Interaction to Next Paint.
Diferente das outras duas, o CLS não tem unidade. É uma pontuação: 0 significa que nada se mexeu, e cada deslocamento soma conforme quanto da tela se moveu e até onde.
Limites de CLS num relance
| Classificação | CLS no percentil 75 |
|---|---|
| ✓ Bom | ≤ 0,1 |
| ◐ Precisa de melhorias | 0,1 a 0,25 |
| – Ruim | > 0,25 |
Os limites vêm do web.dev. O Google lê o percentil 75 das visitas reais em 28 dias, separadamente para celulares e desktops. Um único deslocamento pode bastar para reprovar: o próprio exemplo do web.dev, um elemento que cobre metade da viewport e desce um quarto dela, marca 0,1875 sozinho.
Por que importa além da pontuação: um deslocamento na hora errada faz as pessoas tocarem no link errado, perderem o ponto onde estavam em um artigo ou apertarem Comprar no item errado. Deslocamentos de layout também indicam um template que não conhece os próprios tamanhos, o que costuma causar outros problemas, como LCP lento quando a imagem hero só recebe tamanho depois de carregar.
Como a pontuação de CLS é calculada
Cada deslocamento recebe uma pontuação:
pontuação do deslocamento = fração de impacto x fração de distância
A fração de impacto é a parte da viewport coberta pelos elementos que se movem, somando antes e depois do movimento. A fração de distância é quanto eles se moveram, dividido pelo maior lado da viewport. Os deslocamentos são então agrupados em janelas de sessão, e o CLS é a janela com o maior total.
| Regra | Valor | Fonte |
|---|---|---|
| Intervalo que encerra uma janela de sessão | 1 s | web.dev |
| Janela de sessão mais longa | 5 s | web.dev |
| Deslocamentos ignorados após um toque ou tecla | em até 500 ms | web.dev |
| Rolagem conta como interação | – | web.dev |
| Deslocamentos após o carregamento contam | ✓ | web.dev |
Daí saem duas coisas. Deslocamentos causados pelo visitante, como abrir um acordeão, não contam se acontecem em até 500 ms do toque. E deslocamentos depois que a página carregou, como um banner que desliza ao rolar ou uma lista infinita que empurra o rodapé, contam, e é por isso que o CLS de campo costuma ser pior que o número de laboratório.
Causas comuns de deslocamento de layout e as correções
| Causa | Correção |
|---|---|
| Imagens sem width e height | Defina os dois, ou aspect-ratio |
| Anúncios, embeds e iframes carregam tarde | Reserve o espaço deles |
| Conteúdo injetado acima do conteúdo | Insira abaixo, ou reserve espaço |
| Banner de cookies ou promoção empurra a página | Sobreponha, com posição fixa |
| Fonte web troca com outras métricas | font-display, size-adjust |
| Animar top, left, width, height | Anime transform no lugar |
| CSS tardio muda o layout | Carregue primeiro o CSS do layout |
| Skeleton do tamanho errado | Use o tamanho final |
Imagens e anúncios são as duas grandes. O SEO ProCheck conta como o BuzzFeed resolveu as duas em Improving CLS at BuzzFeed e como usou dados de usuários reais para encontrar o resto.
Como corrigir os deslocamentos mais comuns
Imagens e vídeo: informe o tamanho ao navegador
Com width e height no HTML, os navegadores modernos calculam a proporção e reservam o espaço antes de o arquivo chegar, mesmo quando o CSS deixa a imagem responsiva:
<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; }
Anúncios e embeds: reserve um espaço
Dê ao contêiner uma altura mínima igual ao tamanho de anúncio mais comum naquele espaço. Se o anúncio não preencher, mantenha o espaço em vez de recolhê-lo, ou recolha só abaixo da primeira tela.
.ad-slot-top { min-height: 250px; }
Fontes: trocar sem refluir
font-display: swap mostra o texto na hora, em uma fonte substituta. Se a substituta for mais larga ou mais alta, o texto reflui quando a fonte web chega. Ajuste o tamanho da substituta com size-adjust e as substituições de métricas, ou faça preload da fonte para que ela normalmente chegue antes da primeira renderização. O guia do web.dev para otimizar o CLS trata de cada caso.
Animação: mova com transform
Uma animação que muda top ou margin desloca tudo ao redor. Uma que usa transform: translate() move só o elemento e nunca conta como deslocamento de layout.
Como descobrir o que se deslocou
| Ferramenta | Campo | Laboratório | Identifica o elemento |
|---|---|---|---|
| PageSpeed Insights | ✓ | ✓ só no carregamento | ✓ |
| Relatório Core Web Vitals do Search Console | ✓ | – | – |
| Painel Performance do Chrome DevTools | – | ✓ | ✓ |
| Biblioteca web-vitals | ✓ | – | ✓ com atribuição |
Uma execução do Lighthouse só vê o carregamento, em um tamanho de tela, sem rolagem e sem escolha de consentimento. Se o CLS de campo é ruim e o de laboratório está bom, o deslocamento quase sempre acontece depois: após rolar, após uma escolha de cookies ou em um tamanho de tela que o teste não usou. Grave um trace no DevTools enquanto rola e clica e olhe a faixa Layout shifts. A página de diagnóstico de CLS alto do SEO ProCheck lista mais lugares para olhar.
Teste cada template uma vez em vez de cada página. Um template de produto com imagens sem tamanho se desloca em todos os produtos. O guia de teste de velocidade em massa mostra como.
Encontre problemas de deslocamento de layout com a Neova
A Neova lê o CLS de campo do Chrome UX Report com a sua chave de API gratuita, por grupo de páginas e com uma tendência de 40 semanas. Durante um crawl, ela também encontra as causas que estão no HTML de cada página e, com o Lighthouse ativado, mede o CLS de laboratório em uma página HTML por grupo de páginas. As verificações:

- CLS acima de 0,1 nos dados de laboratório ou de campo
- HTML acima de 2 MB ou Core Web Vitals fora da faixa boa
- Width e height da imagem não estão definidos, em cada página rastreada, sem precisar do Lighthouse
- Fonte web sem font-display swap ou optional
- Animações não são compostas
- Imagem exibida na proporção errada, com a renderização de JavaScript ativada
Todas as verificações rodam em todos os planos, inclusive o Free, no
Perguntas
Qual é uma boa pontuação de cumulative layout shift?
0,1 ou menos no percentil 75 das visitas reais. Entre 0,1 e 0,25 precisa de melhorias, e acima de 0,25 é ruim.
O CLS conta deslocamentos depois que a página carrega?
Sim. O CLS cobre a visita inteira e informa o pior surto de deslocamentos, uma janela de sessão de até 5 segundos. Deslocamentos em até 500 ms de um clique, toque ou tecla ficam de fora, porque o visitante os esperava.
Por que o meu CLS é 0 no Lighthouse mas ruim no campo?
O Lighthouse vê só o carregamento em uma tela, sem rolagem nem escolha de cookies. Visitantes reais rolam, aceitam banners e usam outros tamanhos de tela, e é aí que os deslocamentos acontecem.
Imagens precisam de width e height se o CSS define o tamanho?
Sim. Com width e height no HTML, o navegador conhece a proporção antes de a imagem carregar e reserva o espaço, enquanto o CSS continua controlando o tamanho exibido.
Pode haver deslocamento de layout sem nenhum conteúdo visível se mexer?
Não. Só contam elementos visíveis que mudam a posição inicial. Um elemento que aparece sem empurrar nada não desloca o layout; um que empurra outro conteúdo para baixo, sim.