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

# File Limits Reference

> Complete reference for file upload limits, size caps, timeouts, and per-plan restrictions in ZeroTwo.

This page provides a complete reference for all file upload limits in ZeroTwo, including size limits, format restrictions, per-plan caps, and tips for working with large files.

***

## Upload Limits

| Limit                   | Value       | Notes                                        |
| ----------------------- | ----------- | -------------------------------------------- |
| Max files per upload    | 10 (Pro+)   | Free plan: 1 file per request                |
| Max file size (general) | 50 MB       | Applies to documents, code, images, audio    |
| Max file size (video)   | 200 MB      | MP4, MOV, WEBM, AVI, MKV                     |
| Upload timeout          | 60 seconds  | Large files on slow connections may time out |
| Files Library storage   | Per-account | No stated hard limit; subject to fair use    |

***

## Per-Plan Upload Limits

The number of files you can attach to a single message depends on your plan.

| Plan       | Files per Message |
| ---------- | ----------------- |
| Free       | 1                 |
| Pro        | Up to 10          |
| Pro 2x     | Up to 10          |
| Plus Ultra | Up to 10          |
| Business   | Up to 10          |

<Note>
  The per-message file limit refers to files attached directly to a single chat message. Files stored in your Files Library can be referenced in any message regardless of this limit.
</Note>

***

## File Size Limits by Type

| File Category | Max Size | Common Formats                             |
| ------------- | -------- | ------------------------------------------ |
| Documents     | 50 MB    | PDF, DOCX, TXT, XLSX, PPTX, CSV, MD        |
| Images        | 50 MB    | JPG, PNG, WEBP, GIF, SVG                   |
| Code files    | 50 MB    | JS, TS, PY, GO, RS, Java, C/C++, HTML, CSS |
| Audio files   | 50 MB    | MP3, WAV, M4A, OGG, FLAC                   |
| Video files   | 200 MB   | MP4, MOV, WEBM, AVI, MKV                   |

***

## Upload Timeout

Uploads that take longer than **60 seconds** are automatically terminated. This primarily affects large files on slow internet connections.

**Approximate upload times by file size and connection speed:**

| File Size      | 10 Mbps connection | 50 Mbps connection |
| -------------- | ------------------ | ------------------ |
| 5 MB           | \~4 seconds        | \~1 second         |
| 25 MB          | \~20 seconds       | \~4 seconds        |
| 50 MB          | \~40 seconds       | \~8 seconds        |
| 100 MB (video) | \~80 seconds\*     | \~16 seconds       |
| 200 MB (video) | \~160 seconds\*    | \~32 seconds       |

\*May exceed the 60-second timeout. Use a faster connection or reduce file size.

***

## Tips for Working with Large Files

**PDFs:**

* Use a PDF compression tool before uploading (many free tools available online)
* For long PDFs, you can reference specific sections in your prompt to help the AI focus
* Split very large PDFs into chapters or sections if they're near the 50 MB limit

**Images:**

* Vision analysis (asking ZeroTwo to describe or analyze an image) does not require high resolution
* Downscale large images to 1920×1080 or smaller — the AI extracts the same information from a smaller file
* Use WEBP format instead of PNG for significantly smaller file sizes with comparable quality

**Code files:**

* Split large codebases into logical modules before uploading
* Upload only the files most relevant to your question rather than entire repositories
* For large projects, consider using the GitHub connector instead of direct file uploads

**Videos:**

* Use a video editor to extract only the relevant clip before uploading
* Lower resolution exports (720p instead of 4K) are usually sufficient for AI analysis
* MP4 with H.264 encoding provides the smallest file sizes for given quality

***

## Supported File Types

For the complete list of all accepted file formats and extensions, see [Supported File Types](/tools/files/supported-file-types).

***

## Common Upload Errors

| Error                                   | Cause                               | Fix                               |
| --------------------------------------- | ----------------------------------- | --------------------------------- |
| "Upload failed — file too large"        | Exceeds 50 MB (or 200 MB for video) | Compress or split the file        |
| "Upload failed — unsupported file type" | File extension not supported        | Convert to a supported format     |
| "Upload timed out"                      | Upload exceeded 60 seconds          | Faster connection or smaller file |

See [Upload Errors](/troubleshooting/upload-errors) and [Common Error Messages](/troubleshooting/common-error-messages) for more detail.