Receita: lazy load sem prejudicar o LCP
Adie imagens e iframes fora da primeira tela e proteja a imagem principal com fetchpriority.
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
widtheheight, 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
widtheheightnas 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
- 01Abra a página e identifique a imagem de LCP.
- 02Confirme no HTML que ela não tem loading="lazy" e que tem fetchpriority="high".
- 03Garanta width e height em todas as imagens.
- 04Aplique lazy às demais, inclusive iframes.
- 05Ajuste exceções com filtros do núcleo.
- 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.
- No Chrome, painel Rede, filtro Img: recarregue sem rolar. Só as imagens da primeira tela devem aparecer.
- Role devagar. As demais devem ser pedidas pouco antes de entrar na tela.
- Inspecione a imagem de LCP: não pode ter
loading="lazy". - Rode o Lighthouse: o aviso "Largest Contentful Paint image was lazily loaded" não deve aparecer.
- Conferir CLS no painel Desempenho: sem saltos quando as imagens chegam.
Erros comuns e como desfazer
| Erro | Efeito | Correção |
|---|---|---|
| Lazy na imagem principal | LCP atrasa | loading="eager" e fetchpriority="high" |
| Imagens sem dimensões | CLS | defina width e height |
| JavaScript de lazy load duplicado ao nativo | trabalho dobrado | use só o atributo nativo |
fetchpriority="high" em muitas imagens | a dica perde sentido | só no LCP |
content-visibility sem tamanho intrínseco | barra de rolagem pula | defina 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.
widtheheightem 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
- Browser-level image lazy-loading for the web, web.dev (2024-08-13)
- Optimize resource loading with the Fetch Priority API, web.dev (2023-11-14)
- wp_get_loading_optimization_attributes(), WordPress Developer Resources (2026-10-14)
- 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.