O que é o Cumulative Layout Shift (CLS) e como o corrigir

O que o CLS mede, como se calcula a pontuação e que causas verificar primeiro.

  • Bom ≤ 0,1
  • Precisa de melhorias ≤ 0,25
  • Mau > 0,25
Arjen Karel
Atualizado a · 12 min de leitura
Partilhar

Cumulative Layout Shift (CLS) em resumo

O Cumulative Layout Shift (CLS) é a métrica de estabilidade visual nas Core Web Vitals: uma pontuação para quanto conteúdo visível se move sozinho enquanto o visitante utiliza a página, calculada a partir da pior rajada de layout shifts. Um bom CLS é de 0,1 ou menos no percentil 75 dos carregamentos de página, com mobile e desktop avaliados em separado.

O que é o Cumulative Layout Shift (CLS)?

Um layout shift é um elemento visível que muda de posição entre dois frames sem o visitante o pedir: a linha que estava a ler desce, ou um botão move-se debaixo do polegar porque apareceu um banner por cima.

O CLS não tem unidade: é uma pontuação, enquanto o Largest Contentful Paint (LCP) e o Interaction to Next Paint (INP) são tempos. Há quem escreva CLS por extenso como "content layout shift"; o C significa Cumulative.

O que é uma boa pontuação de Cumulative Layout Shift (CLS)?

Uma boa pontuação de CLS é de 0,1 ou menos em pelo menos 75% dos carregamentos de página, com mobile e desktop avaliados em separado. Mais de 0,1 até 0,25 precisa de melhorias; mais de 0,25 é fraco. Aponte para o 0: um shift dentro do intervalo bom continua a mover o texto que alguém está a ler. Nos dados de utilizadores reais de 133 projetos do CoreDash, pelo menos metade dos carregamentos de página em telemóveis teve um CLS de 0 nos 28 dias até 9 de novembro de 2026.

Avaliação CLS no percentil 75 Problema no Search Console
Bom 0,1 ou menos Nenhum
Precisa de melhorias Mais de 0,1 até 0,25 Problema de CLS: mais de 0,1 (telemóvel)
Problema de CLS: mais de 0,1 (desktop)
Fraco Mais de 0,25 Problema de CLS: mais de 0,25 (telemóvel)
Problema de CLS: mais de 0,25 (desktop)

CLS thresholds: good up to 0.1, needs improvement up to 0.25, poor above 0.25

No Search Console, "Problema de CLS: mais de 0,1 (telemóvel)" significa que um grupo dos seus URLs tem um CLS acima de 0,1 no percentil 75 das visitas em telemóveis, e "mais de 0,25" significa acima de 0,25; "(desktop)" é o mesmo para visitas em desktop. Verifique também o desktop: segundo o State of Web Vitals, 88,9% dos sites têm um bom CLS em telemóveis contra 78,1% em desktop.

Porque é que o CLS é importante para os visitantes e o SEO?

A Google utiliza o CLS no ranking como uma das três Core Web Vitals, medido nos visitantes reais do Chrome: o percentil 75 dos últimos 28 dias. É um fator secundário: a Google indica que uma boa experiência de página ajuda quando as páginas têm relevância semelhante.

Para o visitante, uma página que não para de se mover parece estragada. No Lighthouse, o CLS vale um quarto da pontuação de Performance, mas a Google posiciona a sua página com base no CLS que os visitantes reais obtêm.

Como é medido o CLS?

O Chrome calcula a pontuação de cada layout shift inesperado multiplicando a impact fraction pela distance fraction, e agrupa shifts com menos de um segundo de intervalo numa rajada de, no máximo, 5 segundos. O CLS de uma página é a pontuação da pior rajada durante toda a visita. Cole isto na consola do Chrome para registar cada shift:

new PerformanceObserver((entryList) => {
  for (const entry of entryList.getEntries()) {
    console.log('Layout shift:', entry);
  }
}).observe({type: 'layout-shift', buffered: true});

Cada entrada tem um value, a pontuação desse shift, e sources, os elementos que se moveram. Um shift logo após um clique tem hadRecentInput definido como true.

Como se calcula a pontuação de um layout shift?

layout shift score = impact fraction * distance fraction

A impact fraction representa a parte do viewport que os elementos em movimento ocupam, somando o antes e o depois do shift. A distance fraction é a distância que percorreram, como proporção da maior dimensão do viewport (num telemóvel, a altura). Um elemento que ocupe metade do viewport e desça um quarto dele afeta 75% do viewport: 0,75 * 0,25 = 0,1875, acima de 0,1 por si só.

Que layout shifts contam?

O Chrome ignora qualquer shift ocorrido nos 500 milissegundos seguintes a um clique, toque ou pressão de tecla; por isso, um menu que abre ao clicar não conta para nada. O conteúdo que surge mais tarde conta: um botão de "carregar mais" cujos itens chegam um segundo depois provoca um layout shift. Mostre os itens, ou o espaço reservado para eles, dentro desses 500 milissegundos.

Os shifts durante o scroll contam por inteiro, como um cabeçalho que encolhe ou um anúncio que é preenchido. Uma animação com transform move píxeis sem alterar o layout, pelo que o Chrome não regista qualquer shift.

Sessões de layout shift

O Chrome chama session window a uma rajada de layout shifts. Apenas a sessão mais elevada conta, pelo que sessões de 0,095 e 0,15 dão um CLS de 0,15.

Five layout shifts on a time axis from 0 to 6 seconds. Shifts of 0.06 at 0.8 seconds and 0.035 at 1.5 seconds make session 1, 0.095. After 2.5 seconds without a shift, shifts of 0.08 at 4.0 seconds, 0.05 at 4.6 seconds and 0.02 at 5.4 seconds make session 2, 0.15. The highest session, 0.15, is the CLS.

Cinco shifts medidos no Chrome numa página de teste: um intervalo de um segundo ou mais (aqui 2,5 segundos) inicia a sessão 2.

Numa página de receita de teste construída como um blogue de culinária em WordPress, uma web font, uma foto sem dimensões, uma barra de newsletter e um anúncio obtiveram, cada um, menos de 0,1 isoladamente e, em conjunto, formaram uma rajada de 0,241. O aviso Layout shift culprits do Lighthouse mostra os quatro shifts.

Porque é que o CLS é mais baixo no Lighthouse do que no Search Console?

O Lighthouse carrega a página uma única vez, em tamanho de telemóvel, como um visitante que entra pela primeira vez, e nunca faz scroll nem toca no ecrã. Os field data do Search Console guardam todas as visitas durante toda a sua duração, incluindo o anúncio a meio de um artigo que carrega durante o scroll, e é esse o CLS com base no qual a Google define o ranking. Quando o Lighthouse está limpo e o Search Console indica que o CLS é fraco, os shifts acontecem geralmente após o carregamento.

O Lighthouse também pode mostrar mais do que o terreno. Um font swap, ou uma imagem que o tema dimensiona com width: auto, só sofre shift enquanto o ficheiro não estiver na cache do browser: o Lighthouse e quem visita pela primeira vez veem-no; um developer só o vê com a cache desativada. Mais detalhes em lab and field data.

O que causa layout shifts?

Cada layout shift resulta de algo que chega após o first paint sem espaço à espera, ou de uma animação que altera o layout; tudo o que está por baixo move-se também.

Causa O que o visitante vê De onde costuma vir
Imagens e vídeos sem dimensões O texto salta para baixo quando a imagem chega Tema, page builder, slider, app
Web fonts O texto move-se com a troca de fonte Fontes do tema, Google Fonts
Anúncios e embeds O conteúdo desce pela altura do anúncio Plugin de anúncios, AdSense, YouTube, mapas
Barras e banners A página inteira desce Plugin de consentimento, app, tag manager
CSS tardio O cabeçalho cresce após o first paint CSS diferido de um plugin de otimização
Animações Blocos deslizam durante o carregamento ou scroll Tema, slider, cabeçalho fixo

De acordo com o State of Web Vitals, 89% dos sites sem redes de anúncios passam no CLS em telemóveis, contra 73% dos sites com duas ou mais redes. Trata-se de uma correlação.

O Lighthouse lista os shifts de um carregamento de página em Layout shift culprits (chamado "Avoid large layout shifts" antes do Lighthouse 13).

Como encontrar e corrigir problemas de CLS?

Os layout shifts desaparecem quando tudo o que chega tarde tem espaço reservado, ou move-se sem alterar o layout: largura e altura nas imagens, uma fonte de fallback dimensionada como a web font, uma altura fixa em blocos de anúncios e barras, folhas de estilo carregadas no head e animações que usam transform. Primeiro, descubra que elemento se move para os visitantes reais, por dispositivo, e corrija primeiro o maior shift: é o que mais melhora a pontuação de CLS.

  1. Search Console: anote que grupos de URLs falham em mobile e desktop e observe a tendência: uma subida repentina significa que uma release acrescentou algo, como um banner ou um bloco de anúncios.
  2. Dados de visitantes reais: no CoreDash, agrupe o CLS em mobile por Attribution Element (CLS) para ver que elementos se moveram; o Last interaction (CLS) indica se o shift ocorreu após um scroll.
CoreDash, Cumulative Layout Shift by Attribution Element (CLS) on mobile: per element the p75 CLS, a performance label, the distribution and the sessions; the rows include main#main.site-main, the recipe name, an in-content ad slot, the nav and the footer.

CoreDash em mobile: reproduza primeiro a linha do topo.

  1. Reproduza o problema no Chrome: criei a Core Web Vitals Visualizer, uma extensão gratuita para o Chrome, e é a primeira coisa que abro para ver o que se move numa página. Para ver quando cada shift acontece, grave a página no painel Performance com a cache desativada e Slow 4G: inicie a gravação, recarregue a página, faça scroll para baixo e pare. Cada shift é um losango roxo na faixa Layout shifts, e passar o cursor sobre um deles mostra o que se moveu.
  2. Verifique o elemento indicado pelo Lighthouse: o Lighthouse deduz a causa com base no timing, pelo que uma imagem com dimensões definidas que foi apenas empurrada pode surgir listada como "Unsized image element". Confirme se a imagem não tem mesmo dimensões antes de a alterar (como verificar).
Chrome DevTools Performance panel: the Layout shifts track with four diamonds in the worst layout shift cluster, the tooltip of the 0.0583 shift showing the page with a green newsletter bar that has just appeared above the header, and the Layout shift culprits insight on the left listing two unsized images and a web font.

A página de receita de teste: o shift selecionado com o cursor é uma barra de newsletter a surgir acima do cabeçalho.

Encontrar e corrigir problemas de CLS tem o diagnóstico completo. Para cada causa abaixo, procure uma opção no tema, plugin ou app antes de alterar código.

Imagens e vídeos sem dimensões

Uma imagem sem largura e altura começa com altura zero e empurra tudo o que estiver por baixo quando chega. Um plugin de performance pode adicionar as dimensões em falta (no WP Rocket: Media, Add missing image dimensions); num template, escreva-as manualmente:

<img src="hero.jpg" width="800" height="600" alt="...">
img { max-width: 100%; height: auto; }

O browser converte os dois atributos numa proporção e reserva a altura antes de o ficheiro chegar; com um vídeo funciona da mesma forma. Um width: auto no CSS do tema anula essa proporção, algo que já vi em dezenas de sites (auto sizing images). Imagens e multimédia aborda srcset e carrosséis; Unsized image element detalha o código por plataforma.

Web fonts

O texto aparece primeiro numa fonte de fallback e depois na web font, que é mais larga ou mais estreita: as quebras de linha mudam de sítio e tudo o que está por baixo move-se. O font-display: swap elimina o aviso de Font display e mantém o shift, porque o swap é o shift. Uma fonte de fallback redimensionada para as medidas da web font com metric overrides impede isso, tal como o font-display: optional, que mostra o fallback a quem visita pela primeira vez e nunca faz o swap.

O WordPress e o Shopify não têm qualquer opção para isto: a fonte de fallback é inserida em CSS Adicional no WordPress ou em Edit code no Shopify. No Next.js, o next/font adiciona um fallback correspondente. A fonte do título na página de receita de teste:

@font-face {
  font-family: "Young Serif Fallback";
  src: local("Times New Roman"), local("Liberation Serif");
  size-adjust: 131%;
  ascent-override: 79.85%;
  descent-override: 27.94%;
  line-gap-override: 0%;
}
h1 { font-family: "Young Serif", "Young Serif Fallback", serif; }

Nessa página, um size-adjust de 122% obtido numa calculadora ainda deixava um CLS de 0,029; com 131% passou a 0. O artigo Font display apresenta a fonte para Android e como obter os valores para a sua fonte.

Two mobile screens showing Sample CLS page layout shifts before and after web font swap fix, connected by Aa icon

Um swap de fonte numa página de teste em WordPress, antes e depois do fix.

Anúncios e embeds

O script de anúncios preenche o bloco após o leilão, pelo que um bloco sem altura empurra tudo o que estiver por baixo. No tema ou no plugin de anúncios, atribua ao bloco a altura do formato de anúncio mais frequente e defina o iframe como bloco:

.ad-slot { min-height: 50px; }
.ad-slot iframe { display: block; }

Sem a segunda linha, o iframe assenta na linha de texto, e o espaço reservado na página de receita de teste ainda cresceu 8 píxeis. Mantenha o bloco na sua altura quando não houver anúncios (no Google Publisher Tag, omita collapseEmptyDivs()): um bloco que se fecha move a página tanto quanto um que carrega. Os anúncios automáticos do AdSense entram onde a Google decide; por isso, exclua o primeiro ecrã em Ad settings, Excluded areas.

Os embeds do YouTube e do Google Maps precisam de um aspect-ratio no iframe, ou de uma facade: uma miniatura com dimensões que se transforma no iframe ao clicar (YouTube, Google Maps, o código).

Barras, banners e blocos inseridos por um script

Uma barra de newsletter ou um banner de consentimento colocado por um script acima do cabeçalho empurra a página inteira para baixo. Mude o plugin ou a app para uma barra inferior, uma caixa ou um popup: estes flutuam sobre a página e não movem nada. Uma barra que tenha de ficar no topo recebe o seu espaço reservado no tema:

<div id="promo-slot" style="min-height: 48px"></div>

O conteúdo visível de uma tag do Google Tag Manager surge sempre depois do first paint: passe-o para o template. Avaliações ou produtos relacionados que o JavaScript renderiza após o carregamento precisam de um contentor vazio com a sua altura final (barras e banners).

CSS que carrega após o first paint

Uma folha de estilo que um plugin de otimização adia ou carrega de forma assíncrona altera o estilo da página depois de esta já estar no ecrã: um cabeçalho que cresce empurra tudo o que estiver por baixo. Exclua essa folha de estilo nas definições do plugin, ou carregue-a com um simples <link rel="stylesheet"> no head (late CSS).

Animações, sliders e efeitos de scroll

Uma animação de top, left, height ou margin altera o layout a cada frame, e cada frame pode ser um layout shift: anime transform em alternativa. Um tema com transition: all anima também as propriedades de layout, pelo que a página pode sofrer shifts enquanto carrega (transições de CSS). Especifique apenas as propriedades que pretende:

.card { transition: opacity .2s, transform .2s; }

Um slider mostra os slides empilhados até o respetivo script correr: mostre apenas o primeiro slide até o script adicionar a classe ready (o código). Um cabeçalho que encolhe com o scroll move tudo o que estiver por baixo, a menos que use transform: grave um scroll no painel Performance para ver esse shift (animações acionadas por scroll).

WordPress

  • Imagens: as imagens da biblioteca multimédia têm as suas dimensões; o WP Rocket adiciona as restantes.
  • Fontes: a fonte de fallback em Apresentação, Personalizar, CSS adicional.
  • Anúncios: uma altura fixa no bloco do plugin de anúncios; Áreas excluídas no AdSense para o primeiro ecrã.
  • Barras e banners de consentimento: a disposição em barra inferior, caixa ou popup do plugin.
  • CSS tardio: exclua a folha de estilo do tema do CSS adiado ou assíncrono do plugin de otimização.

Mais detalhes por plugin no guia de WordPress.

Shopify

O filtro image_tag do Shopify insere a largura e a altura; um tema ou app que escreva a sua própria tag <img> precisa de width="{{ image.width }}" height="{{ image.height }}". A fonte de fallback é colocada numa folha de estilo em Editar código, onde uma atualização do tema a pode remover. Um app block como estrelas de avaliação ou uma barra de aviso precisa de altura no seu contentor. Mais detalhes no guia de Shopify.

O que revelou o teste A/B da Rakuten 24 sobre o CLS?

Rakuten 24 otimizou uma landing page para as Core Web Vitals e comparou-a com a versão original durante um mês, dividindo o tráfego a metade. O CLS desceu 92,72%, e a página otimizada obteve 53,37% mais receita por visitante e uma taxa de conversão 33,13% superior. O tempo de carregamento, o FCP e o TTFB melhoraram no mesmo teste, pelo que esses resultados pertencem à otimização como um todo.

Porque é que o Search Console ainda mostra o CLS antigo?

O Search Console analisa os últimos 28 dias; por isso, duas semanas após o lançamento de um fix, metade do que ele mostra ainda é o site antigo. Demora até 28 dias a ficar verde. Pode ver o resultado mais cedo: corra o Lighthouse novamente em mobile depois de limpar o plugin de cache e a CDN, e grave a página no painel Performance enquanto recarrega e faz scroll. Sem qualquer shift, a faixa Layout shifts fica vazia. O CoreDash mostra o novo CLS por elemento a partir das visitas seguintes.

Alguns layout shifts têm origem em código que não pode editar: um parceiro de anúncios cujos criativos mudam de tamanho, uma app que injeta o seu widget, ou um tema sem opção de configuração para a sua barra. Numa Core Web Vitals power hour, analisamos os seus field data e uma gravação do template que se move, e definimos quanto espaço deve ter cada elemento.

About the author

Arjen Karel is a web performance consultant and the creator of CoreDash, a Real User Monitoring platform that tracks Core Web Vitals data across hundreds of sites. He also built the Core Web Vitals Visualizer Chrome extension. He has helped clients achieve passing Core Web Vitals scores on over 925,000 mobile URLs.

Arjen Karel

Precisa de um site mais rápido?

Sou o Arjen e há 17 anos que corrijo sites lentos. Se tem problemas que não consegue resolver sozinho, envie-me o seu URL e falamos.

Envie-me o seu URL
Arjen Karel
Arjen Karel, Consultor de web performance desde 2009

Porque é que o nosso fix não está a funcionar?

Por vezes a CDN ainda serve o HTML antigo, ou o fix foi feito no template de desktop e o mobile usa outro. Envie-me o seu URL e o problema, e respondo com alguns horários. Primeiro analiso os seus field data, depois dedicamos uma hora ao seu site, e no prazo de um dia tem as minhas notas por escrito. 350 € sem IVA.

Envie-me o seu URL

Sem programador para fazer o fix? Faço eu o trabalho, numa cópia do seu site.

Arjen KarelCLS ainda no vermelho em mobile?Envie-me o seu URL