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

# Files Overview

> Upload files to ZeroTwo for AI analysis, or manage all your uploads in the Files Library at /files.

Files in ZeroTwo serve two distinct purposes: **immediate analysis** in a chat, and **persistent storage** in your Files Library. You can attach a file to a message for instant AI processing, or access previously uploaded files from `/files` and re-attach them to any future conversation.

## Two Ways to Use Files

**Attach to a chat** — click the paperclip icon or drag-and-drop a file onto the chat input. ZeroTwo processes the file and responds in context of your message. Best for one-off analysis.

**Files Library at `/files`** — every file you upload is automatically saved to your library. Browse, search, filter, and re-attach any past file to a new chat without uploading it again. Best for reference documents, templates, and data you use repeatedly.

## What ZeroTwo Does with Your Files

The capability ZeroTwo applies depends on the file type:

| File Category                               | What ZeroTwo Does                                                    |
| ------------------------------------------- | -------------------------------------------------------------------- |
| **Documents** (PDF, DOCX, PPTX, XLSX, etc.) | Full text extraction, Q\&A, summarization, translation               |
| **Code** (JS, TS, PY, GO, and more)         | Review, explain, refactor, identify bugs, generate tests             |
| **Data** (CSV, JSON, Parquet, etc.)         | Analyze patterns, compute statistics, generate visualizations        |
| **Images** (PNG, JPG, GIF, WEBP, etc.)      | Vision analysis — describe content, OCR text extraction, visual Q\&A |
| **Audio** (MP3, WAV, M4A, etc.)             | Whisper transcription followed by discussion and summarization       |
| **Video** (MP4, MOV, WEBM, etc.)            | Frame extraction + vision analysis — describe scenes, find moments   |
| **Notebooks** (IPYNB, Rmd)                  | Full cell and output reading — explain code, methodology, results    |

## Upload Limits

| Limit               | 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 |

<Info>
  All plans support file uploads. Pro and higher plans allow up to 10 files per message and support larger video file uploads up to 200 MB.
</Info>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Document Q&A" icon="file-text">
    Upload a PDF, DOCX, or presentation and ask questions: "What are the key findings in section 3?" or "Summarize the executive summary." ZeroTwo reads the full document and answers in context.
  </Card>

  <Card title="Code Review" icon="file-code">
    Attach a code file and ask: "Review this for bugs," "Explain what this function does," or "Refactor this using modern patterns." ZeroTwo reads the entire file, not just a snippet.
  </Card>

  <Card title="Data Analysis" icon="database">
    Upload a CSV or JSON file and ask: "Which product category had the highest growth from Q1 to Q3?" or "Show me a summary of this dataset." ZeroTwo reads the data structure and analyzes it.
  </Card>

  <Card title="Audio Transcription" icon="music">
    Attach a meeting recording (MP3, WAV, M4A) and ask: "Transcribe this and list the action items." Whisper handles the transcription automatically. Works in multiple languages.
  </Card>

  <Card title="Image Analysis" icon="image">
    Upload a screenshot, photo, or chart image and ask: "What does this chart show?" or "Extract all the text from this screenshot." Vision AI describes content and reads text (OCR).
  </Card>

  <Card title="Video Description" icon="video">
    Attach an MP4 or MOV file and ask: "Describe what happens in this video" or "What steps does the presenter demonstrate?" ZeroTwo extracts frames and applies vision analysis.
  </Card>
</CardGroup>

## Files Library

Every file you upload is automatically saved to your **Files Library** at `/files`. From there you can:

* Search files by name
* Filter by type (Documents, Images, Audio, Video, Code, Data)
* Sort by upload date or file size
* Re-attach any file to a new chat without re-uploading
* Download files back to your device
* Delete files you no longer need

<Tip>
  Use the Files Library to build a personal knowledge base. Upload reference documents, style guides, code templates, or data files once — then pull them into any conversation with a few clicks.
</Tip>

## Privacy

Your uploaded files are stored in **per-account Supabase storage**, encrypted at rest. Files are private to your account — no other user can access them. ZeroTwo does not use your uploaded files to train models. Files uploaded within a project are scoped to that project.

## Files Pages

<CardGroup cols={2}>
  <Card title="Upload Files" icon="upload" href="/tools/files/upload-files">
    How to attach files using the paperclip icon or drag-and-drop.
  </Card>

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

  <Card title="Supported File Types" icon="file-text" href="/tools/files/supported-file-types">
    Full list of supported formats and how ZeroTwo processes each one.
  </Card>

  <Card title="Retention and Storage" icon="database" href="/tools/files/retention-and-storage">
    How files are stored, how long they persist, and how to delete them.
  </Card>

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