# Files (/create/files)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 404 · updated: 2026-07-30 -->
Related: [Changelogs](/create/changelogs.md), [Format code](/create/code.md), [Images and embeds](/create/image-embeds.md), [Lists and tables](/create/list-table.md), [Personalized content](/create/personalization.md), [Redirects](/create/redirects.md)

Mintlify automatically serves static assets from your documentation repository at the appropriate path on your domain. For example, if you have `/images/logo.png` in your repo, the image file is available at `https://docs.your-project.com/images/logo.png`.

You can make any supported file type available to your users, including OpenAPI specifications, images, videos, and more.

Files must be less than 20 MB.

<Note>
  File serving is not supported for documentation sites with authentication enabled. If your site requires authentication, static files are not accessible at their direct URLs.
</Note>

## Supported file types [#supported-file-types]

Supported file types for all plans:

* **Images**: `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg`, `.ico`
* **Video**: `.mp4`, `.webm`
* **Audio**: `.mp3`, `.wav`
* **Data**: `.json`, `.yaml`
* **Stylesheet**: `.css`
* **Scripts**: `.js`
* **Fonts**: `.woff`, `.woff2`, `.ttf`, `.eot`

Supported file types for Enterprise plans:

* **Documents**: `.pdf`, `.txt`
* **Data**: `.xml`, `.csv`
* **Archives**: `.zip`

## File organization [#file-organization]

Organize your files using folders to keep your repository easy to navigate:

```text
/your-project
  |- docs.json
  |- images/
    |- logo.png
    |- screenshots/
      |- dashboard.png
  |- assets/
    |- whitepaper.pdf
    |- demo-video.mp4
```

Mintlify serves files from the root of your domain, so the structure in your repository directly maps to the URL structure. From the previous example, `assets/whitepaper.pdf` would be available at `https://docs.your-project.com/assets/whitepaper.pdf`.