{"section":"tutorials","requestedLocale":"pt","requestedSlug":"configurando-tipos-de-arquivos","locale":"pt","slug":"configurando-tipos-de-arquivos","path":"docs/pt/tutorials/storefront/configurações-da-loja---storefront/configurando-tipos-de-arquivos.md","branch":"main","content":"No Admin VTEX, você pode definir as dimensões padrão e o tamanho máximo (em KB) dos arquivos usados na sua loja, principalmente as imagens de produto do Catálogo. Essas configurações influenciam a validação do upload de imagens no Admin e, nas lojas **CMS Portal (Legado)**, também os comportamentos de storefront, como zoom e miniaturas.\n\n> ⚠️ A validação de **Tamanho Máximo em KB** no upload de imagens de produto/SKU no Catálogo vale para lojas [CMS Portal (Legado)](https://help.vtex.com/pt/docs/tracks/cms-portal-legado) e [Store Framework](https://help.vtex.com/pt/docs/tracks/implementacao-de-frontend#store-framework). Saiba mais em [Configurando zoom e miniaturas em lojas CMS Portal (Legado)](/pt/docs/tutorials/configurando-zoom-e-miniaturas-em-lojas-cms-portal-legado).\n\n![Lista de tipos de arquivos no Admin](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/storefront/configurações-da-loja---storefront/configurando-tipos-de-arquivos_1.png)\n\n> ℹ️ Na listagem, a coluna **Tamanhos** exibe o resumo no formato `{largura}px x {altura}px | {tamanho}KB`.\n\n## Instruções\n\n### Configurar tipos de arquivos\n\nPara configurar os tipos dos arquivos de sua loja, siga estes passos:\n\n1. No Admin VTEX, acesse **Configurações da loja > Storefront > Configurações**.\n2. Clique na aba **Tipos de arquivos**.\n3. Na lista, localize o tipo desejado e clique em `Editar`.\n4. Preencha os campos descritos em [Campos do tipo de arquivo](#campos-do-tipo-de-arquivo).\n5. Clique em `Salvar`.\n\n> ⚠️ Não altere as dimensões de um tipo se já existirem imagens cadastradas com essa configuração. Se for necessário alterar o tamanho, apague e recadastre as imagens do tipo modificado.\n\n#### Campos do tipo de arquivo\n\nAo clicar em `Editar`, o formulário apresenta os campos abaixo:\n\n| Campo | Descrição |\n| :--- | :--- |\n| **Nome** | Identifica o tipo de arquivo na lista (por exemplo, `Produto - Zoom` ou `Produto - Thumb`). |\n| **Largura** e **Altura** | Apresentam as dimensões padrão em pixels (`largura` x `altura`) associadas ao tipo. |\n| **Tamanho Máximo em KB** | Delimita o tamanho máximo do arquivo em quilobytes (KB). É o principal critério de validação no upload de imagens de produto no Catálogo. |\n| **Tipo** | Define se o tipo é Imagem (usa largura/altura e pode ser redimensionada/comprimida) ou Arquivo (arquivo genérico, sem restrição de pixels). |\n| **Flag de ajuste de tamanho obrigatório** | Quando marcada, obriga o redimensionamento da imagem para a largura e a altura configuradas. Quando desmarcada, as dimensões não são forçadas no upload. |\n\n### Corrigir uploads bloqueados\n\nO upload de imagens de produto e de SKU no Catálogo respeita o **Tamanho Máximo em KB** configurado para o tipo de arquivo correspondente.\n\nSe o valor estiver em **0KB** ou for baixo demais, o Admin pode rejeitar o upload mesmo quando:\n\n- O arquivo abre normalmente no computador.\n- A mesma imagem sobe sem erro em outra conta ou em outro ambiente.\n- O arquivo está dentro das [boas práticas gerais de imagens do Catálogo](/pt/docs/tutorials/boas-praticas-para-o-uso-de-imagens-no-catalogo).\n\nPara corrigir uploads bloqueados, siga estes passos:\n\n1. No Admin VTEX, acesse **Configurações da loja > Storefront > Configurações > Tipos de arquivos**.\n2. Clique em `Editar` no tipo de imagem de produto afetado (por exemplo, `Produto - Principal` ou `Produto - Giga`).\n3. Aumente o valor de **Tamanho Máximo em KB** para um limite compatível com suas imagens (valores comuns na plataforma incluem limites da ordem de milhares de KB, como `3000KB`).\n4. Salve a configuração e tente fazer o upload novamente no cadastro do SKU.\n\n> ⚠️ Dimensões configuradas como `0px x 0px` costumam indicar ausência de restrição de largura/altura para aquele tipo. Já **0KB** no tamanho máximo bloqueia uploads."}