# Archivos

La página de **Files** es donde gestionas todos los archivos subidos a tu tienda — imágenes de productos, logotipos, banners y cualquier otro archivo. Desde aquí puedes navegar, buscar, subir y eliminar archivos.

Abre **Files** en la barra lateral del panel de administración para comenzar.

## Explorando tus archivos

La lista de archivos muestra cada archivo subido en una tabla con miniatura, nombre de archivo, tipo, tamaño y fecha de subida.

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

| Columna     | Descripción                                                                          |
| ----------- | ------------------------------------------------------------------------------------ |
| Preview     | Miniatura del archivo (las imágenes muestran la imagen real)                         |
| Filename    | Nombre del archivo almacenado (haz clic en el ícono de copiar para copiar el enlace) |
| Link        | Copia la URL del archivo o ábrelo en una nueva pestaña                               |
| Type        | Categoría del archivo — Image, Video, Audio, PDF o Document                          |
| Size        | Tamaño del archivo en formato legible (KB, MB)                                       |
| Uploaded At | Fecha en que se subió el archivo                                                     |

Puedes **ordenar** haciendo clic en los encabezados de las columnas Filename, Size o Uploaded At, y **buscar** escribiendo en la barra de búsqueda en la parte superior. Usa el botón **Filter** para filtrar resultados por tipo de archivo.

## Subiendo archivos

Haz clic en el botón **Upload Files** en la esquina superior derecha para abrir el diálogo de subida. Puedes arrastrar y soltar archivos o hacer clic para explorar tu computadora. Se pueden subir varios archivos a la vez.

Los formatos soportados incluyen imágenes (PNG, JPEG, SVG, WebP), videos, audio, PDFs y otros tipos comunes de documentos.

> **Importante:** Las imágenes están limitadas a **5 MB** por archivo. Las imágenes subidas se preprocesan automáticamente — se optimizan y redimensionan — para reducir su tamaño, lo que garantiza que tus páginas carguen más rápido y mejora tu posicionamiento en SEO.

## Acciones masivas

Selecciona uno o más archivos usando las casillas de verificación a la izquierda, luego usa la barra de acciones masivas que aparece en la parte inferior:

- **Delete** — elimina permanentemente los archivos seleccionados (aparecerá un diálogo de confirmación)

## Acciones por archivo

Haz clic en el menú **...** en cualquier fila para acceder a las acciones individuales del archivo:

- **Delete** — elimina permanentemente este archivo

> **Importante:** Eliminar un archivo es permanente y no se puede deshacer. Si el archivo está siendo usado por un producto, colección o sección de página, esas referencias se romperán.

## Modos de almacenamiento

Capyshop admite dos backends de almacenamiento para los assets subidos, elegidos en el momento del deploy mediante la variable de entorno `ASSETS_STORAGE_MODE`.

- **Local (predeterminado)** — los archivos se escriben en `data/files/` dentro del contenedor de la aplicación y son servidos directamente por la app. Las variantes de imagen se generan en tiempo real y se cachean en `data/files/.cache/`.
- **S3** — los archivos se suben a un bucket compatible con S3 (AWS S3, Cloudflare R2, Backblaze B2, MinIO, etc.) y se sirven desde un CDN. Cuando subes una nueva imagen, se pre-generan variantes WebP optimizadas en anchos comunes (200/400/600/800/1200) y se almacenan junto al original, para que la tienda sirva imágenes del tamaño correcto sin conversión en tiempo de ejecución.

Una configuración opcional `ASSETS_MAX_BYTES` limita el consumo acumulado de almacenamiento en ambos modos — útil para mantener las facturas del bucket predecibles en hosting compartido. Los límites por carga (5 MB imagen / 50 MB video) son independientes de esta configuración.

Consulta [Despliegue con Docker](/es/docker-deployment#opcional-almacenamiento-de-assets-en-s3) para la lista completa de variables de entorno de S3 y el script que migra una tienda existente en modo local a S3.