Menu
Feedback
Comece aqui
Tutoriais
Portal do desenvolvedor

Problemas conhecidos
Diretivas de suporte
Troubleshooting

Perguntas frequentes
Comunicados
Tutoriais
Tutoriais
Explore tutoriais detalhados para operar sua loja VTEX.
Tutoriais
Catálogo
Produtos e SKUs
Melhorar a performance de imagens de produtos
Melhorar a performance de imagens de produtos

As imagens dos produtos são muitas vezes o principal vilão da performance de sua loja.

O objetivo deste artigo é mostrar como usar o VTEX Img para tornar o carregamento das imagens mais eficiente e melhorar a performance do site.

O VTEX Img, serviço que entrega essas imagens ao front da loja, tem uma pequena API que, se bem utilizada, pode trazer grandes benefícios aos seus clientes.

A URL da imagem de um SKU tem o seguinte formato: http://[ACCOUNT_NAME].vteximg.com.br/arquivos/ids/[ID](-[LARGURA]-[ALTURA])/([NOME_DA_IMAGEM])

O que está entre colchetes são valores que mudam de acordo com a loja, SKU e imagem (ou seja, o account name da loja, o ID, a largura, a altura e o nome da imagem).

O que está entre parênteses são parâmetros opcionais (ou seja, largura, altura e nome da imagem).

Exemplo

O nosso catálogo envia as imagens dos SKUs no seguinte formato: http://instoreqa.vteximg.com.br/arquivos/ids/155602/robo.jpg

Nessa URL, temos:

  • [ACCOUNT_NAME]: instoreqa
  • [ID]: 155602
  • [LARGURA]: não especificada
  • [ALTURA]: não especificada
  • [NOME_DA_IMAGEM]: robo.jpg

O nome da imagem é um parâmetro opcional. Por isso, a mesma imagem é entregue se abrirmos a seguinte URL: http://instoreqa.vteximg.com.br/arquivos/ids/155602/

Melhorando a performance

A maneira mais eficaz de melhorar a performance das imagens é fazer com que elas tenham o tamanho que será realmente usado no site. Por exemplo:

Uma loja quer exibir em uma página a imagem de um produto com tamanho de 50x50. Imagine que a loja escreva em seu código html a seguinte URL: http://instoreqa.vteximg.com.br/arquivos/ids/155602/robo.jpg

Neste caso, o navegador irá baixar a imagem com tamanho completo, ou seja, a mesma imagem em alta definição que foi enviada no upload para o Catálogo.

Isso significa que os dados que estão sendo trafegados estão além do necessário, o que é ruim para a performance da loja.

O que fazer?

Podemos pedir ao VTEX Img que envie a imagem em um tamanho específico.

No nosso exemplo anterior, basta escrever da seguinte maneira a URL da imagem no código html: http://instoreqa.vteximg.com.br/arquivos/ids/155602-50-50/

Desta forma, o VTEX Img entregará a imagem com um tamanho de 50x50. Isto tornará seu carregamento muito mais rápido.

{"base64":"  ","img":{"width":738,"height":206,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":16968,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Catalog/Products%20and%20SKUs/melhorando-a-performance-de-imagens-do-site_1.png"}}
Entregar imagens em um tamanho maior que o de exibição prejudica a performance da sua loja.

Imagens retangulares

Ao redimensionar imagens retangulares, o VTEX Img mantém sua proporção, ou seja, elas são redimensionadas sem distorção.

Em lojas de roupas, por exemplo, é muito comum as imagens terem um formato de retrato, em que a altura é maior do que a largura, como 300x400. Se a loja precisar dessa imagem quadrada (num formato de 50x50, por exemplo) ela acabará distorcida.

O VTEX Img impede distorções completando o espaço vazio com um fundo branco.

Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na comunidade VTEX.
Junte-se à nossa comunidade
Solicite suporte à VTEX
Para assistência personalizada, entre em contato com nossos especialistas.
Abra um ticket de suporte
GithubDeveloper portalComunidadeFeedback