receita

Receita: lazy load sem prejudicar o LCP

Adie imagens e iframes fora da primeira tela e proteja a imagem principal com fetchpriority.

resposta curtaLazy load adia o download de imagens e iframes que ainda não estão perto da tela, com o atributo loading="lazy". A regra que evita dano: nunca aplique à imagem do LCP nem a nada visível no carregamento, e sempre declare width e height. O WordPress já faz grande parte disso desde a versão 6.3; esta receita mostra como conferir, ajustar e testar.
Neste texto

Que problema esta receita resolve?

Páginas com muitas imagens baixam tudo de uma vez, disputam banda com o que importa e atrasam a primeira tela. O atributo nativo loading="lazy" resolve isso sem JavaScript. O erro típico é aplicá-lo a todas as imagens, inclusive à principal: o navegador então adia justamente o recurso que define o LCP. O web.dev adverte para não carregar de forma preguiçosa imagens prováveis de estarem na tela ao carregar, em especial a do LCP.

A lógica vem de um plugin de lazy load que Camillo Dantas desenvolveu; ele não é vendido. Aqui estão o critério e o código para fazer sozinho.

Quando usar e quando não usar

Use em imagens e iframes abaixo da primeira tela: galerias, miniaturas de posts relacionados, vídeos incorporados no meio do texto, mapas no rodapé.

Não use:

  • na imagem de destaque do topo, no logotipo ou em qualquer imagem visível ao abrir a página;
  • em imagens sem width e height, porque o lazy load pode aumentar o deslocamento de layout (CLS) quando a imagem chega e empurra o texto;
  • em carrosséis cuja primeira lâmina é o LCP.

Pré-requisitos

  • WordPress 6.3 ou mais recente (para as heurísticas automáticas).
  • Saber qual é o elemento de LCP (PageSpeed Insights ou painel Desempenho).
  • Tema que emita width e height nas imagens (o núcleo faz isso para imagens da mídia).
  • Nível: iniciante a intermediário.

O que o WordPress já faz

A função wp_get_loading_optimization_attributes(), introduzida na 6.3.0, devolve loading="lazy", fetchpriority="high" e decoding="async" conforme o contexto. As regras documentadas: imagens em contexto de cabeçalho são tratadas como visíveis; no laço principal, as primeiras mídias, até o limite de wp_omit_loading_attr_threshold(), são tratadas como visíveis; quem é considerado visível ganha fetchpriority="high" se a área for de pelo menos 50.000 pixels (wp_min_priority_img_pixels), e quem é considerado fora da tela recebe loading="lazy". Sem width e height, nenhum atributo é adicionado. Atributos que você definir à mão prevalecem.

Conclusão prática: antes de escrever código, abra o HTML renderizado e veja o que o núcleo decidiu.

Passo a passo

  1. 01Abra a página e identifique a imagem de LCP.
  2. 02Confirme no HTML que ela não tem loading="lazy" e que tem fetchpriority="high".
  3. 03Garanta width e height em todas as imagens.
  4. 04Aplique lazy às demais, inclusive iframes.
  5. 05Ajuste exceções com filtros do núcleo.
  6. 06Meça.

Passo 2: forçar o comportamento da imagem principal

Em um template seu, peça a imagem com atributos explícitos:

echo wp_get_attachment_image(
	get_post_thumbnail_id(),
	'large',
	false,
	array(
		'loading'       => 'eager',
		'fetchpriority' => 'high',
		'decoding'      => 'async',
	)
);

A função preserva width, height, srcset e sizes gerados pelo núcleo. Ela não adiciona loading="lazy" quando você já informou loading.

Se o tema coloca a imagem de destaque no corpo e o núcleo a marca como lazy, desative o lazy só nesse contexto com o filtro wp_lazy_loading_enabled (introduzido na 5.5.0), que recebe o valor padrão, o nome da tag e um contexto livre, descrito na documentação como nome do filtro ou da função de origem. A documentação não lista os valores possíveis; imprima $contexto com error_log() em homologação para descobrir o que o seu tema usa e ajuste a comparação:

add_filter( 'wp_lazy_loading_enabled', function ( $ativo, $tag, $contexto ) {
	if ( 'img' === $tag && 'the_post_thumbnail' === $contexto && is_singular() ) {
		return false;
	}
	return $ativo;
}, 10, 3 );

Passo 3: tamanho conhecido

Sem dimensões, o navegador não reserva espaço. No HTML manual, escreva:

<img src="https://seusite.com.br/img/grafico.webp" alt="Gráfico do LCP por semana"
     width="800" height="450" loading="lazy" decoding="async">

E no CSS, deixe a imagem flexível sem perder a proporção:

img { max-width: 100%; height: auto; }

Passo 4: iframes e blocos longos

O atributo loading também vale para iframes, e a especificação foi padronizada. O núcleo aplica a iframes desde a 5.7 em contextos de conteúdo; confira se o seu vídeo incorporado saiu com o atributo e, se não, acrescente:

<iframe src="https://www.youtube-nocookie.com/embed/ID_DO_VIDEO" title="Demonstração"
        width="560" height="315" loading="lazy" allowfullscreen></iframe>

Para seções longas abaixo da dobra, a propriedade content-visibility: auto permite ao navegador pular o trabalho de renderização até que a seção se aproxime da tela. Use com contain-intrinsic-size para reservar espaço e evitar que a barra de rolagem salte:

.secao-abaixo-da-dobra {
  content-visibility: auto;
  contain-intrinsic-size: auto 800px;
}

Faça um teste com cuidado: âncoras e busca na página dentro da seção ocultada se comportam diferente em alguns navegadores. Reverta se algo estranho aparecer.

Como testar

Critério de sucesso: a imagem de LCP carrega com prioridade alta e sem lazy, imagens abaixo da dobra só baixam quando se aproximam e o CLS não aumenta.

  1. No Chrome, painel Rede, filtro Img: recarregue sem rolar. Só as imagens da primeira tela devem aparecer.
  2. Role devagar. As demais devem ser pedidas pouco antes de entrar na tela.
  3. Inspecione a imagem de LCP: não pode ter loading="lazy".
  4. Rode o Lighthouse: o aviso "Largest Contentful Paint image was lazily loaded" não deve aparecer.
  5. Conferir CLS no painel Desempenho: sem saltos quando as imagens chegam.

Erros comuns e como desfazer

ErroEfeitoCorreção
Lazy na imagem principalLCP atrasaloading="eager" e fetchpriority="high"
Imagens sem dimensõesCLSdefina width e height
JavaScript de lazy load duplicado ao nativotrabalho dobradouse só o atributo nativo
fetchpriority="high" em muitas imagensa dica perde sentidosó no LCP
content-visibility sem tamanho intrínsecobarra de rolagem puladefina contain-intrinsic-size

Para desfazer, remova o filtro e as regras de CSS. As imagens voltam ao comportamento padrão do núcleo.

Checklist final

  • Imagem de LCP sem lazy, com alta prioridade.
  • width e height em todas.
  • Iframes abaixo da dobra com lazy.
  • Nenhum plugin duplicando a função.
  • LCP e CLS medidos antes e depois.

Seguindo o assunto

Veja também preload de fontes e imagem LCP e adiar scripts de terceiros. O mini-curso Core Web Vitals no campo ensina a ler os dados reais, e o curso Core Web Vitals cobre o processo completo. No glossário: LCP e CLS.

Fontes

  1. Browser-level image lazy-loading for the web, web.dev (2024-08-13)
  2. Optimize resource loading with the Fetch Priority API, web.dev (2023-11-14)
  3. wp_get_loading_optimization_attributes(), WordPress Developer Resources (2026-10-14)
  4. content-visibility, MDN Web Docs (2026-10-14)

Não sabe por onde começar?

Compare as opções e escolha a trilha pelo seu objetivo.