Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 26 additions & 4 deletions create/files.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,11 @@

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

This works for any file type you want to make available to your users, including images, PDFs, videos, or schemas.
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 for images and 100 MB for other file types.

## Supported file extensions

Mintlify supports the following static file extensions.
## Supported file types

### Image formats
- `.jpeg`, `.jpg`, `.jfif`, `.pjpeg`, `.pjp`
Expand Down Expand Up @@ -44,7 +42,17 @@
- `.wma`
- `.m4a`

### Font formats
- `.woff`
- `.woff2`
- `.ttf`
- `.otf`
- `.eot`

### Document formats

<Note>Document formats are only available for Enterprise plans.</Note>

- `.pdf`
- `.txt`
- `.doc`, `.docx`
Expand All @@ -54,10 +62,24 @@
- `.odt`, `.ods`, `.odp`

### Data formats

<Note>Data formats are only available for Enterprise plans.</Note>

- `.csv`
- `.tsv`
- `.xml`

### Archive formats

<Note>Archive formats are only available for Enterprise plans.</Note>

- `.zip`
- `.rar`
- `.7z`
- `.tar`
- `.gz`
- `.bz2`

## File organization

Organize your files using folders to keep your repository easy to navigate:
Expand All @@ -74,4 +96,4 @@
|- demo-video.mp4
```

Files are served 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`.

Check warning on line 99 in create/files.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

create/files.mdx#L99

In general, use active voice instead of passive voice ('are served').