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

> A dedicated page at /files where all your uploaded files are stored — search, filter, re-attach, and manage them from one place.

The **Files Library** at `/files` is a central repository for every file you have ever uploaded to ZeroTwo. Instead of re-uploading the same document every time you need it, find it in your library and attach it to any new chat in seconds.

<Info>
  The Files Library is per-account and private. Only you can see and access your files. No other ZeroTwo user has access to your library.
</Info>

## Accessing the Files Library

Navigate to the Files Library in two ways:

* Click **Files** in the topbar navigation
* Go directly to `/files` in your browser

## What You Will See

The Files Library displays all your uploaded files sorted by upload date (most recent first, by default). Each file entry shows:

* **File name** and extension
* **File type icon** (document, image, audio, video, code, or data)
* **Upload date**
* **File size**
* **Which chat** it was used in (hover to see the associated conversation)

## Searching and Filtering

<Tabs>
  <Tab title="Search">
    Use the **search bar** at the top of the Files Library to find files by name. Results filter instantly as you type.

    **Search tips:**

    * Search by partial filename: "Q3" will match "Q3-report.pdf", "Q3-data.csv", and "Q3-analysis.xlsx"
    * Search is not case-sensitive
    * Search by file extension: ".pdf" shows all PDFs
  </Tab>

  <Tab title="Filter by Type">
    Use the **type filter** to narrow down by file category:

    * **Documents** — PDF, DOCX, PPTX, XLSX, and other text-based formats
    * **Images** — PNG, JPG, GIF, WEBP, and other image formats
    * **Audio** — MP3, WAV, M4A, and other audio formats
    * **Video** — MP4, MOV, WEBM, and other video formats
    * **Code** — JS, TS, Python, Go, and other source code files
    * **Data** — CSV, JSON, Parquet, and other structured data formats

    Multiple filters can be active at the same time.
  </Tab>

  <Tab title="Sort">
    Sort your files by:

    * **Date uploaded** — newest first or oldest first
    * **File size** — largest first or smallest first
    * **File name** — A to Z or Z to A
  </Tab>
</Tabs>

## Re-Attaching Files from the Library

You can attach any library file to a new or existing chat without re-uploading it:

<Steps>
  <Step title="Open a chat">
    Start a new chat or open an existing one.
  </Step>

  <Step title="Click the paperclip icon">
    Click the paperclip in the prompt bar to open the attach menu.
  </Step>

  <Step title="Select 'From Library'">
    In the attach menu, choose the **From Library** tab (as opposed to uploading from your device).
  </Step>

  <Step title="Find and select your file">
    Browse or search your library. Click a file to select it. You can select multiple files (up to 10 on Pro+).
  </Step>

  <Step title="Confirm and send">
    The selected files appear as attachment previews. Add your message and send.
  </Step>
</Steps>

<Tip>
  Re-attaching from the library is faster than re-uploading. Files are already processed and stored — they attach instantly with no upload wait.
</Tip>

## Downloading Files

To download a file from your library back to your device:

1. Hover over the file entry in the library.
2. Click the **download icon** that appears.
3. The file downloads to your browser's default downloads folder.

The downloaded file is identical to your original upload — ZeroTwo does not modify or re-encode uploaded files.

## Deleting Files

<Warning>
  File deletion is **permanent and cannot be undone**. Once deleted, the file is removed from ZeroTwo's storage and cannot be recovered. Download any files you want to keep before deleting them.
</Warning>

**Delete a single file:**

1. Hover over the file in the Files Library.
2. Click the **delete icon** (trash can) that appears.
3. Confirm the deletion in the dialog.

**Delete all files at once:**
Go to **Settings → Data Controls → Clear Files → Confirm**. This permanently removes all files from your account.

**Effect on existing chats:** Deleting a file removes it from your library and from future access. However, the AI analysis already performed in past chat messages remains intact — the chat history retains ZeroTwo's responses. Only the raw file attachment is gone.

## Project Files

Files uploaded within a **project** are scoped to that project. They appear in:

* The project's own Files tab (accessible from within the project view)
* The main Files Library, tagged with the project name

**To view only files from a specific project:**

1. Open the project from the sidebar.
2. Navigate to the project's **Files** tab.

Project files follow the same search, filter, sort, and delete functionality as the main library.

<Note>
  Deleting a project does not automatically delete its files. Project files remain in your main Files Library tagged with the project name. Delete them individually from `/files` if needed.
</Note>

## Storage and Privacy

| Property         | Details                                                   |
| ---------------- | --------------------------------------------------------- |
| Storage location | Per-account Supabase storage, isolated from other users   |
| Encryption       | Encrypted at rest (AES-256) and in transit (TLS)          |
| Visibility       | Private — only accessible to your account                 |
| Retention        | Files persist until you delete them or close your account |
| Model training   | ZeroTwo does not use your files to train models           |

## Related Pages

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

  <Card title="Retention and Storage" icon="database" href="/tools/files/retention-and-storage">
    How long files are stored and how to manage or export them.
  </Card>

  <Card title="Supported File Types" icon="file-text" href="/tools/files/supported-file-types">
    Every format ZeroTwo accepts and how each is processed.
  </Card>

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