Guia de LCP, INP e CLS com código
Os três limites, como medir em campo, o que causa cada problema e o código que corrige. Do diagnóstico ao critério de aceite.
Para quem é e o que você precisa
Este guia é de nível intermediário. Serve para desenvolvedores, analistas de SEO técnico e donos de site que trabalham com um desenvolvedor. Você precisa de acesso ao código do tema ou do site, ao Search Console e a um navegador baseado em Chromium. Não é necessário pagar nenhuma ferramenta.
Os três limites e como a página passa
| Indicador | O que mede | Meta (bom) |
|---|---|---|
| LCP (Largest Contentful Paint) | tempo até o maior elemento visível ser pintado | 2,5 s ou menos |
| INP (Interaction to Next Paint) | atraso entre clique, toque ou tecla e a atualização da tela | 200 ms ou menos |
| CLS (Cumulative Layout Shift) | quanto o layout se mexe sem o usuário pedir | 0,1 ou menos |
A página passa quando atinge a meta nos três indicadores no percentil 75 das visitas, separando celular e computador. Para o INP, a faixa de "ruim" começa acima de 500 ms. Esses valores vêm da documentação do web.dev e podem ser revistos pelo Google, então confira a página de referência antes de fechar uma meta contratual.
Um ponto de método vale mais que todos os truques: os Core Web Vitals são, antes de tudo, métricas de campo. O Lighthouse mede LCP e CLS em laboratório, mas não mede INP, que depende de interação real. O laboratório serve para reproduzir e consertar. A régua é o campo.
Passo 1: medir em campo
Três fontes, em ordem de esforço:
- 01Search Console, relatório de Core Web Vitals: mostra grupos de URLs por situação, com dados do Chrome UX Report. É a visão mais próxima do que o Google enxerga.
- 02PageSpeed Insights: mostra os dados de campo da URL ou da origem, quando há volume, e o diagnóstico de laboratório ao lado.
- 03Medição própria com a biblioteca web-vitals, para saber qual elemento e qual interação causam o problema nas visitas do seu site.
O código abaixo carrega a versão com atribuição da biblioteca e registra no console o elemento responsável por cada indicador. Use-o em diagnóstico; em produção, empacote a biblioteca no seu próprio build e envie os dados ao seu sistema de análise.
<script type="module">
import { onLCP, onINP, onCLS } from 'https://unpkg.com/web-vitals@5/dist/web-vitals.attribution.js?module';
function registrar(metrica) {
const a = metrica.attribution || {};
const alvo = a.target || a.interactionTarget || a.largestShiftTarget || '(sem alvo)';
console.log(metrica.name, Number(metrica.value.toFixed(3)), metrica.rating, alvo);
}
onLCP(registrar);
onINP(registrar);
onCLS(registrar);
</script>
Para enviar ao seu servidor, a documentação da biblioteca usa navigator.sendBeacon, que funciona mesmo com a página sendo fechada:
import { onCLS, onINP, onLCP } from 'web-vitals';
function enviar(metrica) {
const corpo = JSON.stringify({ nome: metrica.name, valor: metrica.value, id: metrica.id });
navigator.sendBeacon('/vitals', corpo);
}
onCLS(enviar);
onINP(enviar);
onLCP(enviar);
Critério de sucesso do passo: você sabe, para a página mais importante, qual elemento é o LCP, qual interação tem pior INP e qual é o maior deslocamento de layout.
Passo 2: corrigir o LCP
O LCP se divide em quatro partes. O guia de otimização do web.dev sugere uma proporção como referência, não como regra: cerca de 40% no tempo até o primeiro byte (TTFB), menos de 10% no atraso para começar a carregar o recurso, cerca de 40% na duração do carregamento e menos de 10% no atraso de renderização. A parte fora de proporção mostra onde agir.
| Parte desproporcional | Causa comum | Correção |
|---|---|---|
| TTFB alto | servidor lento, sem cache de página | cache de página e CDN |
| Atraso para começar a carregar | imagem descoberta tarde (definida em CSS, ou carregada por JavaScript) | preload e fetchpriority="high" |
| Duração do carregamento | imagem pesada ou em formato antigo | imagem redimensionada em WebP ou AVIF, com srcset |
| Atraso de renderização | CSS ou fonte bloqueando a pintura | CSS crítico, fonte com font-display |
O código mais comum de correção, para uma imagem de destaque:
<link rel="preload" as="image" href="https://www.exemplo.com.br/img/destaque-1200.webp" fetchpriority="high">
<img src="https://www.exemplo.com.br/img/destaque-1200.webp"
width="1200" height="630"
fetchpriority="high"
alt="Descrição objetiva da imagem">
Duas regras, ambas do web.dev: marque com fetchpriority="high" apenas uma ou duas imagens, senão o atributo perde o efeito; e nunca aplique loading="lazy" na imagem do LCP, porque isso cria atraso desnecessário. O preload é necessário quando a imagem só é referenciada em um arquivo CSS ou JavaScript, e dispensável quando o <img> já está no HTML inicial.
Passo 3: corrigir o CLS
As causas mais frequentes e a correção:
- Imagens e vídeos sem dimensões. Declare
widtheheight, ou useaspect-rationo CSS, para o navegador reservar o espaço antes do carregamento. - Incorporações e iframes. Reserve a área com
min-heightouaspect-ratio. - Conteúdo inserido no topo depois do carregamento. Banners e avisos empurram o texto. Reserve o espaço ou posicione o elemento por cima, fora do fluxo.
- Animações que mudam a geometria. Anime com
transform, não comtopouleft. - Troca de fonte. Quando a fonte web chega, o texto muda de tamanho. Use uma fonte reserva com métricas ajustadas.
img, video { max-width: 100%; height: auto; }
.incorporacao { aspect-ratio: 16 / 9; width: 100%; }
@font-face {
font-family: "Marca";
src: url("/fonts/marca-400.woff2") format("woff2");
font-weight: 400;
font-display: swap;
}
@font-face {
font-family: "Marca Reserva";
src: local("Arial");
size-adjust: 104%;
ascent-override: 92%;
descent-override: 24%;
line-gap-override: 0%;
}
body { font-family: "Marca", "Marca Reserva", sans-serif; }
Os valores de size-adjust e dos overrides acima são ilustrativos. Meça a diferença entre a sua fonte e a reserva e ajuste os números até o texto não mudar de lugar na troca. O web.dev também descreve font-display: optional, que só usa a fonte web se ela estiver pronta no primeiro layout, e o carregamento antecipado das fontes críticas com <link rel="preload">.
Passo 4: corrigir o INP
O INP soma três etapas de cada interação: o atraso de entrada (o navegador ocupado antes de rodar o evento), o tempo de processamento dos manipuladores e o atraso de apresentação até o próximo quadro. O padrão de correção é o mesmo: não deixar o thread principal ocupado por mais de 50 ms de uma vez, que é a definição de tarefa longa. A técnica central é ceder o controle ao navegador entre blocos de trabalho:
function cederAoNavegador() {
if (globalThis.scheduler?.yield) {
return scheduler.yield();
}
return new Promise((resolve) => setTimeout(resolve, 0));
}
async function aoClicar() {
atualizarInterface(); // o que o usuário precisa ver já
await cederAoNavegador();
processarDadosPesados(); // o resto depois da pintura
}
O scheduler.yield() existe no Chrome 129, no Edge 129 e no Firefox 142, e o Safari não o suporta; por isso o código tem o plano B com setTimeout. Outras ações do guia de INP: reduzir a execução de scripts de terceiros que ocupam o thread, manter o DOM pequeno e usar content-visibility para adiar a renderização do que está fora da tela.
Exemplo preenchido (simulação)
Um site fictício de reservas mede LCP de 4,1 s no percentil 75 em celular. A medição com atribuição aponta a imagem do cabeçalho como elemento do LCP, e as partes são: TTFB 0,6 s, atraso para carregar 1,9 s, duração 1,0 s, atraso de renderização 0,6 s. O atraso para carregar ocupa 46% do total, muito acima dos 10% de referência. A imagem era definida como fundo em CSS e só era descoberta depois do download da folha de estilo. A correção: trocar por um <img> no HTML com fetchpriority="high". Critério de aceite: nova medição de campo, depois de ciclo suficiente de visitas, com a parte de atraso de carregamento próxima da referência.
Erros comuns
- Otimizar para a nota do laboratório. A nota do Lighthouse sobe e o campo não muda. Confirme sempre em campo.
- Lazy load em tudo. A imagem do LCP não deve ter carregamento tardio.
- Medir uma página e generalizar. O Search Console agrupa por modelo de página. Corrija o modelo, não a URL.
- Aceitar plugin como garantia. Nenhum plugin garante meta. As receitas e plugins de desempenho mostram técnicas, e o campo confirma.
Próximo passo
Depois de corrigir, repita a medição em campo e registre antes e depois com data. Para fechar o ciclo de leitura por robôs, siga para o teste de renderização. Equipes que querem aprender a medir e corrigir juntas podem ver o treinamento para desenvolvimento e TI.
Qual indicador devo corrigir primeiro?
O que está pior no campo e afeta mais páginas. Na dúvida, comece pelo LCP, pois a causa costuma ser concentrada (uma imagem, um servidor) e a correção é rápida de verificar. O CLS vem em seguida, por ser mecânico. O INP exige mais análise de código.
Quanto tempo leva para o Search Console refletir a correção?
Os dados de campo se acumulam ao longo das visitas reais, e o relatório do Search Console se apoia nos dados do Chrome UX Report. Por isso a melhora não aparece de imediato. Acompanhe a medição própria com web-vitals para ver o efeito antes.
O Core Web Vitals garante melhor posição?
Não. Os indicadores medem a experiência de uso da página, e nenhuma documentação oficial garante posição por passar neles. O benefício direto é para o usuário, que espera menos, e para a conversão. Por isso a meta é passar nos três e cuidar do conteúdo.
O FID ainda existe?
O indicador de interatividade dos Core Web Vitals é o INP. A documentação atual do web.dev lista LCP, INP e CLS como os três indicadores. Use o INP. Se algum relatório antigo ainda mostrar FID, trate o dado como histórico e acompanhe o INP no campo e na biblioteca web-vitals.
Fontes
- Web Vitals, web.dev (2024-10-31)
- Optimize Largest Contentful Paint, web.dev (2025-03-31)
- Optimize Cumulative Layout Shift, web.dev (2025-02-07)
- Interaction to Next Paint (INP), web.dev (2025-09-02)
- Optimize long tasks, web.dev (2024-12-19)
- Optimize Interaction to Next Paint, web.dev (2025-09-02)
- web-vitals (biblioteca JavaScript), Google Chrome, GitHub (2026-10-14)
Vamos olhar o seu caso?
Escolha a consultoria, a análise ou o projeto que combina com o seu momento. Cada serviço tem escopo, entregáveis e limites descritos antes da compra.