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

# Files

> View, manage, and download uploaded files and generated outputs.

The Files page is your central library for files associated with your account and projects. Files can be uploaded manually, attached in a conversation, or generated by a [background job](/guides/jobs).

## Viewing your files

Navigate to **Files** in the sidebar. Each file card shows:

* File name and type badge, such as CSV, image, FASTA, H5AD, or PDF
* File size and creation date
* Project association when the file belongs to a project
* **Generated by MIP** badge if the file was produced by a background job or tool

### Filtering and search

Use the controls at the top of the page to find files:

* **Search** by file name
* **By Chat** to filter to files from a specific conversation
* **By Project** to filter to a workspace
* **By Type** to filter by data type
* **Sort** by date, name, or size

## Previewing files

Click any file card to open a preview:

* **Images** such as PNG and SVG render inline
* **Text files** such as CSV, TSV, JSON, FASTA, BED, VCF, and TXT display a preview in a monospace viewer
* **Documents** such as PDFs can be opened or downloaded depending on browser support
* **Binary or large files** such as H5AD, MTX, and archives show a download option when inline preview is not available

## Uploading files

You can upload files in two ways:

* **From chat**: Click the paperclip icon in the chat input to attach a file. It becomes available to MIP for analysis and is saved to your Files library.
* **From the Files page**: Upload directly to your library and assign the file to a project.

Supported file types include `.csv`, `.tsv`, `.json`, `.vcf`, `.fasta`, `.fa`, `.h5ad`, `.bed`, `.mtx`, `.png`, `.jpg`, `.pdf`, `.txt`, `.zip`, and `.gz`.

| Upload method                        | Max file size |
| ------------------------------------ | ------------- |
| Direct upload                        | 5 MB          |
| Large file upload using a signed URL | 500 MB        |

Files larger than 5 MB are uploaded directly to cloud storage using a temporary signed URL. They do not pass through the web server.

## Referencing files in chat

Type `@` in the chat input to open the file picker. Search and select a file to reference it in your message. MIP can then read, analyze, transform, visualize, or process the file as part of its response.

Examples:

* "Summarize @screen\_results.csv and highlight the strongest hits."
* "Use @counts.tsv to create a differential expression plan."
* "Inspect @protein.fasta and identify domains or motifs."

## Downloading and deleting

* **Download**: Click the download button on the file card or in the preview dialog.
* **Delete**: Click the menu on the file card and select **Delete**. A confirmation dialog appears before the file is removed.

## Where files come from

| Source                   | How it gets here                                                                             |
| ------------------------ | -------------------------------------------------------------------------------------------- |
| **Chat uploads**         | You attach a file in a conversation using the paperclip icon                                 |
| **Background jobs**      | A [job](/guides/jobs) generates output files such as results, plots, processed data, or logs |
| **Code execution**       | Purna creates code outputs, transformed datasets, figures, or tables                         |
| **AI-generated outputs** | MIP creates files during analysis, visualization, drafting, or export workflows              |

<Tip>
  After a background job completes, check the Files page for all outputs. Job-generated files are marked with a **Generated by MIP** badge so you can identify them quickly.
</Tip>