mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Ethan Palm
3dc3852b7a
* Improve SEO descriptions across 47 pages Curated descriptions from two bot-generated PRs (#3908, #3949), selecting the best approach for each page: - Added missing title and description frontmatter to 10 API reference pages - Benefit-focused descriptions for integration pages (not implementation-heavy) - Accurate REST-aligned titles for API endpoints (Export, List, Trigger, etc.) - Expanded short descriptions to 50–160 character range throughout Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * copyedit * Update custom-domain.mdx * Fix analytics API page titles to match spec summaries "Export" was inaccurate — spec uses "Get" for both endpoints. Also updated descriptions to use "Retrieve" for consistency. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
51 lines
1.8 KiB
Plaintext
51 lines
1.8 KiB
Plaintext
---
|
|
title: "Files"
|
|
description: "Serve static assets like images, videos, PDFs, and data files directly from your documentation repository."
|
|
keywords: ["static assets","supported file types"]
|
|
---
|
|
|
|
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`.
|
|
|
|
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.
|
|
|
|
<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 for all plans:
|
|
|
|
- **Images**: `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg`, `.ico`
|
|
- **Video**: `.mp4`, `.webm`
|
|
- **Audio**: `.mp3`, `.wav`
|
|
- **Data**: `.json`, `.yaml`
|
|
- **Stylesheets**: `.css`
|
|
- **Scripts**: `.js`
|
|
- **Fonts**: `.woff`, `.woff2`, `.ttf`, `.eot`
|
|
|
|
Supported file types for Enterprise plans:
|
|
|
|
- **Documents**: `.pdf`, `.txt`
|
|
- **Data**: `.xml`, `.csv`
|
|
- **Archives**: `.zip`
|
|
|
|
## 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
|
|
```
|
|
|
|
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`. |