Guia de Core Web Vitals

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.

resposta curtaOs Core Web Vitals têm três metas, medidas no percentil 75 das visitas reais: LCP de 2,5 segundos ou menos, INP de 200 milissegundos ou menos e CLS de 0,1 ou menos. Meça primeiro em campo, com a biblioteca web-vitals ou o Search Console. Depois ataque a causa de cada indicador: imagem principal tardia (LCP), JavaScript que bloqueia a resposta (INP) e elementos sem espaço reservado (CLS).

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

IndicadorO que medeMeta (bom)
LCP (Largest Contentful Paint)tempo até o maior elemento visível ser pintado2,5 s ou menos
INP (Interaction to Next Paint)atraso entre clique, toque ou tecla e a atualização da tela200 ms ou menos
CLS (Cumulative Layout Shift)quanto o layout se mexe sem o usuário pedir0,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:

  1. 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.
  2. 02PageSpeed Insights: mostra os dados de campo da URL ou da origem, quando há volume, e o diagnóstico de laboratório ao lado.
  3. 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 desproporcionalCausa comumCorreção
TTFB altoservidor lento, sem cache de páginacache de página e CDN
Atraso para começar a carregarimagem descoberta tarde (definida em CSS, ou carregada por JavaScript)preload e fetchpriority="high"
Duração do carregamentoimagem pesada ou em formato antigoimagem redimensionada em WebP ou AVIF, com srcset
Atraso de renderizaçãoCSS ou fonte bloqueando a pinturaCSS 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 width e height, ou use aspect-ratio no CSS, para o navegador reservar o espaço antes do carregamento.
  • Incorporações e iframes. Reserve a área com min-height ou aspect-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 com top ou left.
  • 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

  1. Web Vitals, web.dev (2024-10-31)
  2. Optimize Largest Contentful Paint, web.dev (2025-03-31)
  3. Optimize Cumulative Layout Shift, web.dev (2025-02-07)
  4. Interaction to Next Paint (INP), web.dev (2025-09-02)
  5. Optimize long tasks, web.dev (2024-12-19)
  6. Optimize Interaction to Next Paint, web.dev (2025-09-02)
  7. 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.