> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Corregir un archivo estático que devuelve 404 en tu sitio de documentación

> Diagnostica por qué un archivo que agregaste a tu repositorio de documentación (como un JSON, PDF o imagen) no se carga en su URL esperada en tu sitio de Mintlify.

Mintlify sirve archivos estáticos desde tu repositorio de documentación en la ruta que coincide con su ubicación en el repositorio. Si un archivo como `data/prices.json` devuelve `404` cuando solicitas `https://docs.example.com/data/prices.json`, revisa las causas siguientes. Para una visión general de cómo funciona el servicio de archivos estáticos y la lista de tipos de archivo compatibles, consulta [Archivos](/docs/es/create/files).

## Confirma que la URL coincide con la ruta del repositorio

La ruta de la URL refleja la ubicación del archivo en tu repositorio. Un archivo confirmado en la raíz del repositorio como `prices.json` se sirve en `https://docs.example.com/prices.json`. Un archivo en `data/prices.json` se sirve en `https://docs.example.com/data/prices.json`.

Errores comunes:

* Diferencia de mayúsculas. `Prices.json` y `prices.json` son URLs distintas.
* El archivo solo está en una rama de funcionalidad. Solo se sirven los archivos confirmados en la rama que Mintlify construye.
* Un error tipográfico en la extensión. Mintlify sirve el archivo con el nombre exacto que tiene en el repositorio.

Confirma que el archivo existe en la rama desplegada abriéndolo directamente en la interfaz web de tu proveedor de Git.

## Comprueba que el tipo de archivo es compatible

Mintlify solo sirve los tipos de archivo listados en [Tipos de archivo compatibles](/docs/es/create/files#supported-file-types). Algunos tipos, como `.pdf`, `.txt`, `.xml`, `.csv` y `.zip`, solo se sirven en planes Enterprise. Un archivo con una extensión no compatible devuelve `404` aunque exista en el repositorio.

## Comprueba el tamaño del archivo

Los archivos deben ser menores de 20 MB. Los archivos más grandes no se sirven y deben alojarse en una CDN externa o en un almacén de objetos.

## Descarta la autenticación

El servicio de archivos estáticos no está disponible para sitios de documentación con [autenticación](/docs/es/deploy/authentication-setup) habilitada. Las URLs directas a archivos devuelven `404` en sitios autenticados incluso cuando el archivo existe y el usuario ha iniciado sesión. Aloja el archivo en un servicio externo si tu sitio requiere autenticación.

## Descarta `.mintignore` y otras exclusiones

Comprueba si el archivo coincide con un patrón en `.mintignore`. Mintlify no publica archivos que coincidan con patrones de `.mintignore`, por lo que no estarán disponibles en su URL. Consulta [Excluir archivos de la publicación](/docs/es/organize/mintignore).

Mintlify también ignora automáticamente directorios como `node_modules`, `build`, `dist` y `.git`. Un archivo dentro de uno de esos directorios no se sirve. Mueve el archivo a un directorio que no se ignore automáticamente, como `assets/` o `data/`. Consulta la lista completa de directorios ignorados por defecto en [Patrones ignorados por defecto](/docs/es/organize/mintignore#default-ignored-patterns).

## Redespliega después de agregar el archivo

Mintlify construye tu documentación cuando envías cambios a tu rama de despliegue. Un archivo recién añadido solo está disponible después de la siguiente build exitosa. Abre el historial de despliegues de tu panel y confirma que el commit que agregó el archivo se construyó correctamente antes de volver a probar la URL.


## Related topics

- [Archivos](/docs/es/create/files.md)
- [SEO](/docs/es/optimize/seo.md)
- [Roles](/docs/es/dashboard/roles.md)