# Arquivos

A página de **Arquivos** é onde você gerencia todas as mídias enviadas à sua loja — imagens de produtos, logotipos, banners e quaisquer outros arquivos. A partir daqui, você pode navegar, pesquisar, enviar e excluir arquivos.

Abra **Files** na barra lateral do painel de administração para começar.

## Navegando pelos seus arquivos

A lista de arquivos exibe cada arquivo enviado em uma tabela com miniatura, nome do arquivo, tipo, tamanho e data de envio.

![Lista de arquivos](/features/files/files-list.png)

| Coluna      | Descrição                                                                 |
| ----------- | ------------------------------------------------------------------------- |
| Preview     | Miniatura do arquivo (imagens mostram a imagem real)                      |
| Filename    | Nome do arquivo armazenado (clique no ícone de copiar para copiar o link) |
| Link        | Copie a URL do arquivo ou abra em uma nova aba                            |
| Type        | Categoria do arquivo — Image, Video, Audio, PDF ou Document               |
| Size        | Tamanho do arquivo em formato legível (KB, MB)                            |
| Uploaded At | Data em que o arquivo foi enviado                                         |

Você pode **ordenar** clicando nos cabeçalhos das colunas Filename, Size ou Uploaded At, e **pesquisar** digitando na barra de busca no topo. Use o botão **Filter** para filtrar resultados por tipo de arquivo.

## Enviando arquivos

Clique no botão **Upload Files** no canto superior direito para abrir o diálogo de envio. Você pode arrastar e soltar arquivos ou clicar para navegar no seu computador. Vários arquivos podem ser enviados de uma vez.

Os formatos suportados incluem imagens (PNG, JPEG, SVG, WebP), vídeos, áudio, PDFs e outros tipos comuns de documentos.

> **Importante:** Imagens são limitadas a **5 MB** por arquivo. As imagens enviadas são automaticamente pré-processadas — otimizadas e redimensionadas — para reduzir seu tamanho, garantindo que suas páginas carreguem mais rápido e melhorando seu posicionamento em SEO.

## Ações em massa

Selecione um ou mais arquivos usando as caixas de seleção à esquerda, depois use a barra de ações em massa que aparece na parte inferior:

- **Delete** — remove permanentemente os arquivos selecionados (um diálogo de confirmação aparecerá)

## Ações por arquivo

Clique no menu **...** em qualquer linha para acessar as ações individuais do arquivo:

- **Delete** — remove permanentemente este arquivo

> **Importante:** Excluir um arquivo é permanente e não pode ser desfeito. Se o arquivo estiver sendo usado por um produto, coleção ou seção de página, essas referências serão quebradas.

## Modos de armazenamento

A Capyshop suporta dois backends de armazenamento para os assets enviados, escolhidos no momento do deploy através da variável de ambiente `ASSETS_STORAGE_MODE`.

- **Local (padrão)** — os ficheiros são gravados em `data/files/` dentro do contentor da aplicação e servidos diretamente pela app. As variantes de imagem são geradas em tempo real e cacheadas em `data/files/.cache/`.
- **S3** — os ficheiros são enviados para um bucket compatível com S3 (AWS S3, Cloudflare R2, Backblaze B2, MinIO, etc.) e servidos a partir de um CDN. Quando uma nova imagem é enviada, variantes WebP otimizadas em larguras comuns (200/400/600/800/1200) são pré-geradas e armazenadas junto do original, para que a loja sirva imagens do tamanho correto sem qualquer conversão em tempo de execução.

Uma definição opcional `ASSETS_MAX_BYTES` limita o consumo cumulativo de armazenamento em ambos os modos — útil para manter as faturas do bucket previsíveis em alojamentos partilhados. Os limites por upload (5 MB imagem / 50 MB vídeo) são independentes desta definição.

Veja [Deploy com Docker](/pt/docker-deployment#opcional-armazenamento-de-assets-em-s3) para a lista completa de variáveis de ambiente S3 e o script de migração que move uma loja existente em modo local para S3.