> ## 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.

# Upload Files

> Attach files to your ZeroTwo chat messages using the paperclip icon or drag-and-drop — for immediate AI analysis.

You can attach files to any chat message in ZeroTwo. There are two ways: click the **paperclip icon** in the prompt bar, or **drag-and-drop** files directly onto the chat input area. Both methods work the same way and support the same file types and limits.

## Two Upload Methods

<Tabs>
  <Tab title="Paperclip Icon">
    1. Click the **paperclip icon** in the prompt bar at the bottom of the chat.
    2. Your file picker opens. Select one or more files (hold `Cmd/Ctrl` to select multiple on desktop).
    3. Selected files appear as **attachment previews** above the text input.
    4. Type your prompt — or leave it blank and ZeroTwo will infer what to do.
    5. Press Enter or click **Send**.
  </Tab>

  <Tab title="Drag and Drop">
    1. Open your file manager, desktop, or Downloads folder.
    2. Drag one or more files over the ZeroTwo chat window.
    3. The input area highlights to indicate it is ready to receive files.
    4. Drop the files. They appear as **attachment previews** above the input.
    5. Type your prompt (or leave blank).
    6. Press Enter or click **Send**.
  </Tab>
</Tabs>

## Step-by-Step Guide

<Steps>
  <Step title="Initiate the upload">
    Click the paperclip icon or drag files onto the chat input area.
  </Step>

  <Step title="Select your files">
    Choose the files you want to attach. Limits by plan:

    * **Free plan:** 1 file per message
    * **Pro+:** Up to 10 files per message
  </Step>

  <Step title="Review attachment previews">
    Each file appears as a preview above the input field, showing the filename and a thumbnail or file-type icon. To remove a file before sending, click the **X** on its preview.
  </Step>

  <Step title="Write your prompt">
    Add a question or instruction in the text field. For example:

    * "Summarize the key findings from this report."
    * "What does this function do and how can I improve it?"
    * "Transcribe this audio and pull out the action items."
    * "Compare the financial projections in these two documents."

    If you send the file without a message, ZeroTwo will infer what to do based on the file type — but a specific instruction produces better results.
  </Step>

  <Step title="Send">
    Press **Enter** or click the **Send** button. An upload progress indicator shows while files transfer to ZeroTwo's servers.
  </Step>

  <Step title="Wait for analysis">
    ZeroTwo processes the file and responds. Processing time varies:

    * Small documents and images: near-instant
    * Large PDFs or code files: a few seconds
    * Audio transcription: roughly 1 second per minute of audio
    * Video analysis: depends on video length and resolution
  </Step>
</Steps>

## Upload Limits

| Property              | Free Plan  | Pro+       |
| --------------------- | ---------- | ---------- |
| Files per message     | 1          | Up to 10   |
| Max file size         | 50 MB      | 50 MB      |
| Max video file size   | 50 MB      | 200 MB     |
| Upload timeout        | 60 seconds | 60 seconds |
| Max files per message | 1          | 10         |

<Warning>
  If your file exceeds the size limit or the upload takes longer than 60 seconds, the upload will fail. Compress large files, use lower-resolution video, or split large documents into sections.
</Warning>

## What ZeroTwo Does with Each File Type

| File Type                             | What ZeroTwo Does                                           |
| ------------------------------------- | ----------------------------------------------------------- |
| PDF, DOCX, PPTX, XLSX                 | Extracts full text for Q\&A, summarization, and translation |
| Code files (JS, PY, TS, GO, etc.)     | Reads full source for review, explanation, and refactoring  |
| Data files (CSV, JSON, Parquet, etc.) | Analyzes structure, statistics, and patterns                |
| Images (PNG, JPG, GIF, WEBP, etc.)    | Vision analysis — description, OCR, visual questions        |
| Audio (MP3, WAV, M4A, etc.)           | Whisper transcription + discussion                          |
| Video (MP4, MOV, WEBM, etc.)          | Frame extraction + vision analysis                          |
| Notebooks (IPYNB, Rmd)                | Full cell and output reading                                |

See [Supported File Types](/tools/files/supported-file-types) for the complete format list.

## Writing Effective File Prompts

ZeroTwo responds to the file in context of your message. Specific instructions produce more useful output.

| Instead of...               | Try...                                                                                    |
| --------------------------- | ----------------------------------------------------------------------------------------- |
| (no message, just the file) | "Summarize this PDF in 5 bullet points"                                                   |
| "What is this?"             | "This is a quarterly sales report — what are the top 3 trends?"                           |
| "Fix this"                  | "Review this Python file for bugs and explain each issue with a suggested fix"            |
| "Analyze the data"          | "Which product category had the highest revenue growth from Q1 to Q3?"                    |
| "Transcribe this"           | "Transcribe this meeting recording and list all action items with the person responsible" |

## Combining Multiple Files

When you attach multiple files (Pro+ only), you can reference them together in a single message:

```
Here are two versions of the product spec. Compare them and highlight what changed between v1 and v2.
```

```
I've attached three quarterly reports. Summarize revenue trends across all three quarters.
```

ZeroTwo reads all attached files in context and can cross-reference information between them.

## After Uploading

**Progress indicator:** While the file uploads, a progress bar or spinner appears on the attachment preview. Do not close the tab during upload.

**Upload complete:** The progress indicator disappears and the preview shows the final file state.

**Removing an attachment before sending:** Click the **X** on any file preview to remove it from the pending message. This does not delete the file from your Files Library if it was previously saved there.

**After sending:** The file is attached to that specific chat message. It is also automatically saved to your [Files Library](/tools/files/files-library) for reuse in future chats.

<Info>
  All uploaded files are automatically saved to your Files Library at `/files`. You can re-attach them to any future chat without uploading again — no duplicate storage.
</Info>

## Related Pages

<CardGroup cols={2}>
  <Card title="Supported File Types" icon="file-text" href="/tools/files/supported-file-types">
    Complete list of accepted formats and how each is processed.
  </Card>

  <Card title="Files Library" icon="folder" href="/tools/files/files-library">
    Browse and re-attach all your previously uploaded files.
  </Card>

  <Card title="Files Overview" icon="upload" href="/tools/files/overview">
    How files work in ZeroTwo — uploading, storage, and use cases.
  </Card>

  <Card title="Troubleshooting" icon="search" href="/tools/files/troubleshooting">
    Fix upload failures, size errors, and missing analysis.
  </Card>
</CardGroup>
