Tamanho da imagem destacada WordPress: 1200×630 + veja o seu

Resposta curta: se você ainda não sabe o tamanho do seu tema, use 1200 x 630 pixels (cerca de 1.91:1). É o tamanho de prévia de link que o Facebook recomenda, e os plugins de SEO costumam usar a imagem destacada como imagem de compartilhamento.

No próprio post, o tamanho que importa é o que o seu tema exibe. O WordPress guarda cada upload em vários tamanhos, e o tema escolhe qual deles aparece. Temas clássicos definem isso com set_post_thumbnail_size() ou add_image_size(); temas de blocos definem no bloco Imagem destacada. Se o tema corta em 16:9 ou quadrado, uma imagem de 1200 x 630 pode perder parte das bordas esquerda e direita. Descubra o tamanho do seu tema (veja as quatro formas abaixo) e depois envie uma imagem pelo menos desse tamanho, ou com cerca do dobro da largura para ficar nítida em telas de alta densidade.

Para ver todos os tamanhos que o WordPress vai criar a partir de uma imagem específica, coloque-a na ferramenta de tamanhos de imagem do WordPress.

Qual tamanho usar, conforme o lugar onde a imagem aparece

Onde a imagem aparece	Tamanho para enviar	Observações
Seus posts, sem saber ainda o tamanho do tema	1200 x 630, ou 2400 x 1260 para mais nitidez	Também serve para prévias de links enquanto você descobre o tamanho do seu tema
Seus posts, com o tamanho do tema conhecido	Cerca do dobro da largura da imagem destacada do seu tema, na mesma proporção	O WordPress cria cópias menores de um upload, nunca maiores
Prévias de links no Facebook	Pelo menos 1200 x 630 (cerca de 1.91:1); 1200 x 628 tem quase o mesmo formato	Segundo as orientações de compartilhamento do Facebook
Google Discover	Pelo menos 1200 px de largura, 16:9 (por exemplo, 1200 x 675)	Segundo as diretrizes do Google Discover

Tamanhos de imagem do WordPress em resumo

Cada imagem enviada recebe cópias redimensionadas para cada tamanho registrado. Estes são os tamanhos que o núcleo do WordPress registra, com os padrões do Theme Handbook e da referência de funções do núcleo:

Nome do tamanho	Dimensões padrão	Dá para mudar em Configurações > Mídia?	Observações
thumbnail	150 x 150, cortado	Sim	Tem a opção “cortar nas dimensões exatas”
medium	até 300 x 300	Sim	Redimensionado proporcionalmente
medium_large	768 de largura, sem limite de altura	Não	Usado principalmente no srcset
large	até 1024 x 1024	Sim	Redimensionado proporcionalmente
1536x1536	até 1536 x 1536	Não	Adicionado no WordPress 5.3 para telas de alta densidade
2048x2048	até 2048 x 2048	Não	Adicionado no WordPress 5.3 para telas de alta densidade
post-thumbnail	Definido pelo tema	Não	Só existe se o tema chamar set_post_thumbnail_size()
full	Seu upload original	Não	Uploads muito grandes são reduzidos antes (veja abaixo)

“Até” significa que o WordPress encaixa a imagem dentro dessa caixa e mantém as proporções. Uma foto de 2000 x 1000 vira 1024 x 512 no tamanho large, e não 1024 x 1024.

Temas e plugins costumam adicionar mais tamanhos com add_image_size(). O WooCommerce, por exemplo, adiciona seus próprios tamanhos de produto, que explicamos no nosso guia de tamanho de imagem de produto do WooCommerce.

Mais uma regra afeta uploads grandes. Desde o WordPress 5.3, se uma imagem tiver mais de 2560 pixels de largura ou altura, o WordPress a reduz e usa a cópia reduzida como o maior tamanho disponível. Esse limite vem do filtro big_image_size_threshold, cujo padrão é 2560. Se você está vendo -scaled nos nomes dos arquivos e quer saber se deve desativar isso, leia como desativar imagens redimensionadas no WordPress.

De onde vem, de fato, o tamanho da imagem destacada

Imagem destacada é qualquer imagem que você define no painel Imagem destacada do editor de posts. O que os visitantes veem depende de como o tema a exibe.

Temas clássicos

Um tema clássico ativa as imagens destacadas e registra o tamanho no seu functions.php:

add_theme_support( 'post-thumbnails' );
set_post_thumbnail_size( 1200, 675, true );

set_post_thumbnail_size() registra um tamanho chamado post-thumbnail. O terceiro argumento controla o corte. Com false (o padrão), o WordPress redimensiona a imagem para caber dentro de 1200 x 675. Com true, ele corta a imagem exatamente em 1200 x 675 a partir do centro, então tudo o que estiver fora de uma caixa 16:9 se perde. Você também pode passar um array como array( 'center', 'top' ) para escolher qual parte será mantida.

Muitos temas registram tamanhos extras com nome para diferentes modelos:

add_image_size( 'hero-wide', 1600, 900, true );
add_image_size( 'card', 600, 400, true );

O modelo então escolhe um deles pelo nome:

if ( has_post_thumbnail() ) {
	the_post_thumbnail( 'hero-wide' );
}

Chamada sem nome, the_post_thumbnail() usa post-thumbnail. Então o tamanho real da imagem destacada em um tema clássico é o tamanho indicado no modelo, e o arquivo do blog pode usar um diferente da página de post individual.

Temas de blocos

Temas de blocos, incluindo os temas gratuitos deste site, exibem a imagem destacada com o bloco Imagem destacada. A referência dos blocos do núcleo lista suas configurações, incluindo sizeSlug (qual tamanho registrado carregar), aspectRatio, width, height e scale.

Isso muda o lugar onde você procura. Abra Aparência > Editor, edite o modelo de Posts individuais e selecione o bloco Imagem destacada. A barra lateral mostra qual tamanho de imagem ele carrega e se há uma proporção definida. A proporção é aplicada no navegador com CSS, então o arquivo continua o mesmo e muda apenas o quadro visível. Se o bloco pede um quadro 16:9 e sua imagem é quadrada, parte dela fica escondida. Os modelos de arquivo e da página inicial podem usar configurações diferentes do modelo de post individual, então confira cada um.

Como descobrir o tamanho de imagem destacada do seu tema

Tente nesta ordem. A primeira opção que der a resposta já basta.

1. Consulte a documentação do tema. Bons temas informam o tamanho recomendado para a imagem destacada. Se estiver lá, use-o.

2. Liste os tamanhos registrados com o WP-CLI. Se você tem acesso à linha de comando, wp media image-size mostra cada tamanho registrado com largura, altura, configuração de corte e proporção:

   wp media image-size

3. Pesquise nos arquivos do tema. Em um tema clássico, procure em functions.php (e nos arquivos que ele inclui) por set_post_thumbnail_size e add_image_size, depois veja em single.php ou nas partes do modelo qual nome é passado para the_post_thumbnail(). Em um tema de blocos, confira o bloco Imagem destacada no Editor do site, como descrito acima.

4. Inspecione um post publicado. Clique com o botão direito na imagem destacada, escolha Inspecionar e leia o nome do arquivo em src. O WordPress adiciona as dimensões às cópias redimensionadas, então my-photo-1200x675.jpg indica que o tema carregou uma cópia de 1200 x 675. Veja também o srcset, porque o navegador pode escolher uma cópia menor em telas estreitas. Sem dimensões no nome, foi usado o arquivo em tamanho completo.

Quando souber o tamanho-alvo, passe uma imagem de teste pela ferramenta de tamanhos de imagem para ver como cada cópia vai ficar antes de enviar um lote.

Como escolher o tamanho do upload

Com o tamanho do tema em mãos, quatro escolhas decidem se o resultado fica bom.

• Largura. Envie pelo menos a largura que o tema exibe. Para ficar nítido em telas de celular e notebook de alta densidade, mire em cerca do dobro dessa largura. Para um espaço de 1200px, isso significa 2400px. O WordPress cria cópias menores a partir do seu upload e nunca cria maiores, então um original pequeno demais é a causa mais comum de uma imagem desfocada depois do upload.
• Proporção. Use a mesma proporção do corte do tema. Se ele corta em 16:9, entregue 16:9 e mantenha o assunto perto do centro para que um corte rígido não corte cabeças ou textos.
• Tamanho do arquivo. Uma foto de 2400px salva em JPEG com qualidade razoável costuma ter algumas centenas de kilobytes. Enviar um arquivo de câmera de 6000px só gera trabalho: o WordPress reduz tudo acima de 2560px de qualquer forma, e os pixels extras nunca chegam aos visitantes.
• Formato do arquivo. O WordPress aceita uploads em WebP desde a versão 5.8 e em AVIF desde a 6.5, desde que a biblioteca de imagens do seu servidor tenha suporte a eles. Os dois costumam gerar um arquivo menor que o JPEG com qualidade parecida.

A imagem para redes sociais é outra tarefa

Quando alguém compartilha seu post no Facebook, LinkedIn ou outras redes, a prévia vem da tag og:image, que os plugins de SEO costumam preencher com a imagem destacada. A documentação de compartilhamento do Facebook recomenda imagens de pelo menos 1200 x 630 pixels, o mais perto possível da proporção 1.91:1.

Você também vai ver 1200 x 628 como recomendação. Esse tamanho fica quase exatamente em 1.91:1, enquanto 1200 x 630 dá cerca de 1.90:1. A diferença é de só 2 pixels de altura, então qualquer um dos dois funciona.

Se o tamanho de exibição do seu tema também estiver perto de 1.91:1, um único upload de 1200 x 630 (ou 2400 x 1260) serve para os dois. Se o tema corta em 16:9 ou quadrado, mantenha o conteúdo importante longe das bordas esquerda e direita ou defina uma imagem social separada no seu plugin de SEO.

O Google Discover tem suas próprias recomendações de imagem. As diretrizes do Google Discover recomendam imagens com pelo menos 1200 px de largura, mais de 300.000 pixels no total e proporção 16:9, como 1200 x 675. Imagens grandes também precisam da diretiva robots max-image-preview:large, que o WordPress adiciona por padrão desde a versão 5.7, a menos que o site esteja configurado para evitar que mecanismos de busca o indexem.

Como alterar o tamanho da imagem destacada

Onde você faz a mudança depende do tamanho e do seu tema.

Tamanhos do núcleo (thumbnail, medium, large). Vá em Configurações > Mídia e altere a largura e a altura. A documentação da tela Configurações de mídia descreve os campos, incluindo a opção de corte para miniaturas.

Tamanhos do tema em um tema clássico. Não edite o tema pai, porque uma atualização do tema vai sobrescrever sua mudança. Adicione os novos valores no functions.php de um tema filho. Registrar de novo um tamanho com o mesmo nome o substitui, e a configuração do tema filho deve rodar depois da do tema pai:

add_action( 'after_setup_theme', function () {
	set_post_thumbnail_size( 1600, 900, true );
	add_image_size( 'hero-wide', 1600, 900, true );
}, 11 );

A prioridade 11 faz o código rodar depois de um tema pai conectado com a prioridade padrão 10. Confira o código do tema pai e ajuste se ele usar uma prioridade mais alta.

Temas de blocos. Altere o tamanho de imagem e a proporção do bloco Imagem destacada no modelo, no Editor do site. Não precisa de código, e a mudança vale para todos os posts que usam esse modelo.

Uma imagem, sem código. Para escolher o que o corte mantém em uma única imagem, abra-a em Mídia > Biblioteca e clique em Editar imagem. Corte-a na proporção do seu tema (a ferramenta de corte aceita uma proporção como 16:9) ou redimensione-a e salve. O WordPress aplica a mudança a todos os tamanhos dessa imagem e mantém o arquivo original, então Restaurar imagem original pode desfazer a alteração depois.

Regenere as miniaturas existentes

Um tamanho alterado só vale para novos uploads. As imagens que já estão na sua biblioteca de mídia mantêm as cópias antigas até você recriá-las. O comando wp media regenerate faz isso:

wp media regenerate --yes

Opções úteis da documentação do WP-CLI:

• --image_size=hero-wide recria só esse tamanho. Repita a opção para vários tamanhos.
• --only-missing cria os tamanhos que ainda não existem e não mexe nos arquivos existentes, o que é mais rápido depois de adicionar um tamanho novo.
• --skip-delete mantém os arquivos de miniatura antigos. Use se outros sites, newsletters ou feeds apontam diretamente para esses arquivos.

Sem acesso à linha de comando, o plugin Regenerate Thumbnails do diretório de plugins do WordPress.org faz o mesmo pelo painel. Faça um backup antes em bibliotecas grandes, porque a regeneração reescreve muitos arquivos.

Erros comuns

• Parar em 1200 x 630. É um bom ponto de partida e serve para prévias de links, mas se o seu tema corta em 16:9 ou quadrado, parte da imagem é cortada. Confira o tamanho do seu tema antes de enviar um lote.
• Desativar os tamanhos gerados para “manter o original”. Se o tema não tiver cópias menores, ele pode acabar carregando o arquivo completo em todas as telas, o que deixa a página lenta no celular. As cópias redimensionadas existem justamente para evitar isso.
• Editar o código de tamanhos de imagem e pular a regeneração. O código funciona, mas só para novos uploads. É por isso que muita gente conclui que a mudança de tamanho “não fez nada”.
• Alterar o tamanho no tema pai. A próxima atualização do tema apaga a mudança. Use um tema filho ou o Editor do site.

Se a imagem ainda parecer errada depois de acertar o tamanho, a proporção e regenerar, compare o nome do arquivo que o navegador carregou com os tamanhos que a ferramenta de tamanhos de imagem diz que o WordPress deveria criar. Quando eles não batem, muitas vezes um plugin de otimização ou um redimensionador de imagens de CDN entre o WordPress e o visitante está servindo sua própria versão.