> ## Documentation Index
> Fetch the complete documentation index at: https://reedai-07fa30f1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Files & History

> Master file uploads and conversation history - organize, search, and manage your AI interactions

## Overview

ZeroTwo helps you stay organized with powerful file management and conversation history features. Upload files to give AI context, and easily find past conversations when you need them.

<Note>
  All files and conversations are private by default. Share only what you choose with team members in projects.
</Note>

## Uploading Files

Add context to your conversations by uploading documents, images, code, and data files.

### How to Upload Files

<Steps>
  <Step title="Choose Upload Method">
    Multiple ways to add files:

    * **Drag & drop**: Drag files directly into the chat input
    * **Click attach**: Click the 📎 button in the input box
    * **Paste images**: Copy and paste images from your clipboard
    * **Keyboard shortcut**: `Cmd/Ctrl + U`
  </Step>

  <Step title="Select Your Files">
    Choose one or multiple files from your computer.

    <Tip>
      Hold `Cmd/Ctrl` to select multiple files at once.
    </Tip>
  </Step>

  <Step title="Wait for Upload">
    Files upload and attach to your message:

    * Small progress indicator appears
    * File thumbnails show in the input area
    * Upload typically completes in seconds
  </Step>

  <Step title="Add Context and Send">
    Type your message explaining what you want to do with the files:

    ```
    Analyze these sales figures and identify top-performing regions
    ```

    Then send your message normally.
  </Step>
</Steps>

### Supported File Types

ZeroTwo accepts a wide variety of file formats:

<Tabs>
  <Tab title="Documents">
    **Text & Documents**:

    * PDF (`.pdf`)
    * Word (`.doc`, `.docx`)
    * Plain text (`.txt`)
    * Markdown (`.md`, `.mdx`)
    * Rich text (`.rtf`)

    **Spreadsheets**:

    * Excel (`.xlsx`, `.xls`)
    * CSV (`.csv`)
    * TSV (`.tsv`)

    **Presentations**:

    * PowerPoint (`.ppt`, `.pptx`)
    * Google Slides exports
  </Tab>

  <Tab title="Images">
    **Raster Formats**:

    * JPEG (`.jpg`, `.jpeg`)
    * PNG (`.png`)
    * GIF (`.gif`)
    * WebP (`.webp`)
    * BMP (`.bmp`)

    **Vector Graphics**:

    * SVG (`.svg`)

    <Info>
      Image analysis requires vision-capable models like GPT-4o, Claude 3.5 Sonnet, or Gemini 2.0 Flash.
    </Info>
  </Tab>

  <Tab title="Code & Development">
    **Source Code** (all major languages):

    * JavaScript/TypeScript (`.js`, `.ts`, `.jsx`, `.tsx`)
    * Python (`.py`)
    * Java (`.java`)
    * C/C++ (`.c`, `.cpp`, `.h`)
    * Go (`.go`)
    * Rust (`.rs`)
    * And many more

    **Configuration**:

    * JSON (`.json`)
    * YAML (`.yml`, `.yaml`)
    * XML (`.xml`)
    * ENV files (`.env`)

    **Web Files**:

    * HTML (`.html`)
    * CSS (`.css`, `.scss`)
    * Vue/Svelte components
  </Tab>

  <Tab title="Data & Archives">
    **Data Files**:

    * SQL scripts (`.sql`)
    * Database files (`.db`, `.sqlite`)
    * JSON Lines (`.jsonl`)
    * Log files (`.log`)

    **Archives**:

    * ZIP (`.zip`)
    * TAR/GZIP (`.tar`, `.gz`)

    **Notebooks**:

    * Jupyter (`.ipynb`)
    * Shell scripts (`.sh`, `.bash`)
  </Tab>
</Tabs>

### File Size Limits

Your upload limits depend on your subscription plan:

<CardGroup cols={2}>
  <Card title="Free Plan" icon="user">
    * Max file size: **25 MB**
    * Files per message: **10**
    * Monthly quota: **1 GB**
  </Card>

  <Card title="Pro Plan" icon="star">
    * Max file size: **100 MB**
    * Files per message: **20**
    * Monthly quota: **10 GB**
  </Card>

  <Card title="Team Plan" icon="users">
    * Max file size: **200 MB**
    * Files per message: **50**
    * Monthly quota: **Unlimited**
  </Card>

  <Card title="Enterprise" icon="building">
    * Max file size: **500 MB**
    * Files per message: **Unlimited**
    * Monthly quota: **Unlimited**
  </Card>
</CardGroup>

<Warning>
  Files exceeding size limits will be rejected. Compress large files or split them into smaller parts to stay within limits.
</Warning>

## Working with Files

### What AI Can Do with Files

<AccordionGroup>
  <Accordion title="Analyze Documents">
    AI can read and extract information from your documents:

    * Summarize key points
    * Answer questions about content
    * Extract specific data
    * Compare multiple documents
    * Generate reports

    **Example**:

    ```
    Summarize the main findings from this research paper
    ```
  </Accordion>

  <Accordion title="Review Code">
    Upload code files for intelligent analysis:

    * Code review and suggestions
    * Bug detection and fixes
    * Add documentation and comments
    * Refactor for better performance
    * Convert between languages

    **Example**:

    ```
    Review this React component and suggest performance improvements
    ```
  </Accordion>

  <Accordion title="Analyze Images">
    Vision models can understand image content:

    * Describe scenes and objects
    * Extract text (OCR)
    * Read charts and diagrams
    * Convert designs to code
    * Compare multiple images

    **Example**:

    ```
    Extract all text from this screenshot and format it as markdown
    ```

    <Info>
      Switch to GPT-4o, Claude 3.5, or Gemini for image analysis.
    </Info>
  </Accordion>

  <Accordion title="Process Data">
    Work with spreadsheets and data files:

    * Statistical analysis
    * Find trends and patterns
    * Clean and format data
    * Generate visualizations
    * Answer data questions

    **Example**:

    ```
    Analyze this sales data and create a Python script to visualize monthly trends
    ```
  </Accordion>
</AccordionGroup>

### Files in Context

Files you upload become part of the conversation:

**Context behavior**:

* Files remain available throughout the chat
* AI can reference files from earlier in the conversation
* File content counts toward conversation context
* Large files may slow response generation

<Tip>
  For best performance, start a new chat when working with many large files rather than continuing a very long conversation.
</Tip>

## Managing Your Files

### Files Page

Access all your uploaded files from the **Files** page in the sidebar.

<Steps>
  <Step title="Open Files Page">
    Click **Files** in the left sidebar navigation.
  </Step>

  <Step title="Browse Your Files">
    View all uploaded files with:

    * File name and type
    * Upload date and size
    * Associated conversations
    * Quick actions menu
  </Step>

  <Step title="Search and Filter">
    Find specific files quickly:

    * Search by filename
    * Filter by file type
    * Sort by date or size
    * View by list or grid
  </Step>

  <Step title="Take Actions">
    Manage individual files:

    * **View details**: Click file for full information
    * **Download**: Save a local copy
    * **Jump to chat**: Open conversation where file was used
    * **Delete**: Remove file permanently
  </Step>
</Steps>

### File Storage

**How files are stored**:

* Encrypted in transit and at rest
* Stored securely in your account
* Associated with specific conversations
* Not used to train AI models
* Can be deleted anytime

**Storage limits by plan**:

* **Free**: 1 GB total storage
* **Pro**: 10 GB total storage
* **Team**: 100 GB total storage
* **Enterprise**: Custom storage limits

<Info>
  Check your current storage usage in Account Settings > Storage.
</Info>

## Conversation History

Keep track of all your AI conversations with powerful history features.

### Viewing Chat History

Your conversations appear in the left sidebar:

**History organization**:

* 📅 **Today**: Conversations from today
* 📅 **Yesterday**: Previous day's chats
* 📅 **Last 7 Days**: Recent week
* 📅 **Last 30 Days**: Recent month
* 📅 **Older**: Archived conversations

**Chat information displayed**:

* Auto-generated title (or your custom title)
* Model used
* Last message timestamp
* Star indicator (if starred)
* Project badge (if in a project)

### Searching Conversations

Find any past conversation quickly using the search feature.

<Steps>
  <Step title="Open Search">
    Use the search bar in sidebar or press `Cmd/Ctrl + K` for quick search.
  </Step>

  <Step title="Enter Search Terms">
    Type keywords from your conversation:

    * Message content
    * File names
    * Topics discussed
    * Model names

    Results appear instantly as you type.
  </Step>

  <Step title="Filter Results">
    Refine your search with filters:

    * **Date range**: `after:2024-01-01`
    * **Model**: `model:gpt-4`
    * **Project**: `in:project-name`
    * **Starred**: `is:starred`
    * **Files**: `has:files`
  </Step>

  <Step title="Open Conversation">
    Click any result to open that conversation exactly where the match was found.
  </Step>
</Steps>

<Tip>
  Search supports natural language queries like "python code I wrote last week" for intuitive results.
</Tip>

### Organizing Conversations

Keep your workspace tidy with organizational tools.

<Tabs>
  <Tab title="Star Important Chats">
    Mark valuable conversations for quick access:

    1. Click the ⭐ **Star** icon in chat header or hover menu
    2. Starred chats appear in a dedicated **Starred** section
    3. Access starred chats quickly from sidebar

    **When to star**:

    * Reference materials
    * Important solutions
    * Templates to reuse
    * Ongoing projects
  </Tab>

  <Tab title="Rename Conversations">
    Customize auto-generated titles:

    1. Click the conversation title in the header
    2. Type your new title
    3. Press `Enter` to save

    **Naming tips**:

    * Be descriptive and specific
    * Include project names
    * Add dates for time-sensitive work
    * Use consistent naming conventions

    **Examples**:

    * "Q4 Marketing Analysis - Dec 2024"
    * "Python Flask API Tutorial"
    * "Client X Website Redesign"
  </Tab>

  <Tab title="Move to Projects">
    Organize related chats into projects:

    1. Right-click the conversation
    2. Select **Move to Project**
    3. Choose destination project
    4. Chat appears in project folder

    <Info>
      Learn more about projects in [Create Project](/projects/create-project).
    </Info>
  </Tab>

  <Tab title="Archive Old Chats">
    Clean up your sidebar without deleting:

    1. Right-click the conversation
    2. Select **Archive**
    3. Archived chats hide from main list
    4. Access via **Archived** section when needed

    **Auto-archiving**:

    * Enable in Settings
    * Archive after 30/60/90 days
    * Keeps sidebar focused on recent work
  </Tab>
</Tabs>

### Deleting Conversations

Remove conversations you no longer need.

<Steps>
  <Step title="Select Conversation">
    Find the conversation in your history sidebar.
  </Step>

  <Step title="Open Delete Menu">
    * Right-click the conversation
    * Select **Delete** from menu
    * Or hover and click the 🗑️ trash icon
  </Step>

  <Step title="Confirm Deletion">
    Confirm you want to permanently delete:

    * All messages in the conversation
    * All uploaded files
    * All AI responses

    <Warning>
      Deletion is permanent and cannot be undone. Consider archiving instead if you might need the conversation later.
    </Warning>
  </Step>
</Steps>

## Exporting Conversations

Save your conversations outside of ZeroTwo.

### Export Options

<Tabs>
  <Tab title="Export Single Chat">
    Download one conversation:

    1. Open the conversation
    2. Click **⋮** menu in header
    3. Select **Export**
    4. Choose format:
       * **Markdown** (`.md`) - readable text
       * **JSON** (`.json`) - structured data
       * **PDF** (`.pdf`) - formatted document
    5. File downloads to your device
  </Tab>

  <Tab title="Export Multiple Chats">
    Bulk export conversations:

    1. Go to **Settings > Data & Privacy**
    2. Click **Export Data**
    3. Select conversations to include
    4. Choose format
    5. Click **Export**
    6. Receive download link via email (for large exports)
  </Tab>

  <Tab title="Export with Files">
    Include uploaded files in export:

    1. Start export as normal
    2. Check **Include uploaded files**
    3. Export creates a ZIP archive
    4. Contains conversation + all files

    <Info>
      Exports with files may take longer for conversations with many or large files.
    </Info>
  </Tab>
</Tabs>

### Export Uses

**Why export conversations**:

* Backup important work
* Share with people outside ZeroTwo
* Archive for compliance
* Create documentation
* Analyze your usage
* Migrate to other platforms

## Best Practices

<AccordionGroup>
  <Accordion title="Name conversations descriptively">
    Help yourself find conversations later:

    * Rename immediately after starting important chats
    * Include project, topic, or client name
    * Add dates for time-sensitive work
    * Use consistent naming scheme

    **Good examples**:

    * "Blog Post: AI Ethics - Draft 2"
    * "Debug User Auth Issue - Prod"
    * "Q1 2024 Sales Analysis"

    **Poor examples**:

    * "New Chat"
    * "Code"
    * "Help"
  </Accordion>

  <Accordion title="Use projects for organization">
    Group related conversations:

    * Create project per client
    * Organize by topic or domain
    * Separate work and personal
    * Archive completed projects

    **Project structure example**:

    ```
    📁 Acme Corp Website
      💬 Initial Requirements Discussion
      💬 Homepage Design Review
      💬 Backend API Planning
      💬 Deployment Checklist
    ```
  </Accordion>

  <Accordion title="Star for quick access">
    Don't rely on search alone:

    * Star conversations you reference often
    * Keep starred list small and focused
    * Unstar when no longer needed
    * Review starred list monthly

    **Good candidates for starring**:

    * Code snippets to reuse
    * Writing style examples
    * Complex solutions you'll reference
    * Active project discussions
  </Accordion>

  <Accordion title="Archive regularly">
    Keep your sidebar manageable:

    * Archive completed projects
    * Archive old experiments
    * Set up auto-archiving
    * Review and archive monthly

    **Benefits**:

    * Faster sidebar loading
    * Easier to find active work
    * Less visual clutter
    * Searchable when needed
  </Accordion>

  <Accordion title="Clean up files periodically">
    Manage your storage quota:

    * Delete unused files monthly
    * Remove duplicate uploads
    * Compress large files before uploading
    * Check storage usage regularly

    **In Files page**:

    1. Sort by size (largest first)
    2. Review large files
    3. Delete or download and remove
    4. Clear old test files
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Cannot find a conversation">
    **Try these steps**:

    1. Use search (`Cmd/Ctrl + K`) with keywords
    2. Check the **Archived** section
    3. Look in relevant projects
    4. Try broader search terms
    5. Check date filters aren't too restrictive

    **Search tips**:

    * Search message content, not just titles
    * Try different related keywords
    * Use date filters: `after:YYYY-MM-DD`
    * Check if conversation was deleted
  </Accordion>

  <Accordion title="File upload fails">
    **Common causes and solutions**:

    **File too large**:

    * Check your plan's file size limit
    * Compress the file
    * Split into smaller parts

    **Unsupported format**:

    * Verify file type is supported
    * Convert to supported format
    * Check file isn't corrupted

    **Network issues**:

    * Check internet connection
    * Try uploading again
    * Upload smaller files first

    **Quota exceeded**:

    * Check storage usage in settings
    * Delete old files
    * Upgrade plan for more storage
  </Accordion>

  <Accordion title="Image not being analyzed">
    **Checklist**:

    1. ✅ Using vision-capable model (GPT-4o, Claude 3.5, Gemini)
    2. ✅ Image format supported (JPEG, PNG, WebP)
    3. ✅ Image under size limit
    4. ✅ Asked specific question about image

    **To fix**:

    1. Switch to vision model using model selector
    2. Upload image again
    3. Ask clear, specific question:
       ```
       Describe everything you see in this image
       ```
  </Accordion>

  <Accordion title="Chat history not loading">
    **Troubleshooting steps**:

    1. Refresh the page (`Cmd/Ctrl + R`)
    2. Clear browser cache
    3. Check internet connection
    4. Try different browser
    5. Contact support if persists

    **Data safety**:

    * Your conversations are safely stored
    * Temporary display issues don't mean data loss
    * Try accessing from different device
  </Accordion>
</AccordionGroup>

## Quick Reference

### Keyboard Shortcuts

| Shortcut       | Action               |
| -------------- | -------------------- |
| `Cmd/Ctrl + U` | Upload file          |
| `Cmd/Ctrl + K` | Quick search         |
| `Cmd/Ctrl + N` | New chat             |
| `Cmd/Ctrl + F` | Find in conversation |
| `Cmd/Ctrl + B` | Toggle sidebar       |

### File Limits by Plan

| Plan       | Max Size | Per Message | Monthly Quota |
| ---------- | -------- | ----------- | ------------- |
| Free       | 25 MB    | 10 files    | 1 GB          |
| Pro        | 100 MB   | 20 files    | 10 GB         |
| Team       | 200 MB   | 50 files    | Unlimited     |
| Enterprise | 500 MB   | Unlimited   | Unlimited     |

## Next Steps

<CardGroup cols={2}>
  <Card title="Keyboard Shortcuts" icon="keyboard" href="/getting-started/shortcuts">
    Learn all keyboard shortcuts for faster workflows
  </Card>

  <Card title="Create Projects" icon="folder" href="/projects/create-project">
    Organize conversations into team projects
  </Card>

  <Card title="Custom Instructions" icon="sliders" href="/chat/custom-instructions">
    Set default file handling preferences
  </Card>

  <Card title="Canvas" icon="pen-to-square" href="/tools/canvas">
    Create documents with AI collaboration
  </Card>
</CardGroup>

<Check>
  You now know how to manage files and conversations effectively - stay organized and productive!
</Check>