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

# Uploading Documents

> How to upload documents to MIRA and control which ones are active in each session.

The **Document Panel** is the collapsible right-side panel in the chat view. It manages all documents available to the current session.

## Uploading a document

<Steps>
  <Step title="Open the Document Panel">
    Click the **Paperclip** icon in the message input toolbar, or press **⌘D**. The Document
    Panel slides open on the right side of the chat window.
  </Step>

  <Step title="Upload">
    Either:

    * **Drag and drop** one or more files directly onto the Document Panel, or
    * Click the **Upload** button and use the file browser to select files

    Multiple files can be uploaded at once.
  </Step>

  <Step title="Wait for parsing">
    Each document card shows a `Parsing` spinner while the background worker extracts text.
    When parsing completes, the card shows `Done` and displays the chunk count.

    Parsing is non-blocking — you can continue chatting while it runs.
  </Step>

  <Step title="Confirm the document is active">
    Newly uploaded documents are automatically toggled **active** in the current session. The
    toggle switch on each document card shows its active/inactive state.
  </Step>
</Steps>

## Per-session toggle

Each document has a **toggle** that controls whether it's injected into the context for the current session. You can:

* **Active (toggle on):** Document content is included in the next query's context
* **Inactive (toggle off):** Document is uploaded and parsed, but not injected

Toggling a document does not delete it. The document remains in the library and can be re-activated in any session.

## Document card information

Each document card displays:

| Field             | Description                                             |
| ----------------- | ------------------------------------------------------- |
| **Filename**      | Original file name                                      |
| **Size**          | File size in KB or MB                                   |
| **Status**        | Parsing / Done / Error                                  |
| **Chunk count**   | Number of text chunks the document was split into       |
| **Active toggle** | Whether the document is included in the current session |

## Removing a document

Click the **✕** button on a document card to remove it. Removing a document:

* Deletes its parsed chunks from `mira.db`
* Removes it from all sessions it was active in
* Does **not** delete the original file from your disk

A confirmation dialog is shown for documents that are active in multiple sessions.

## Context usage indicator

The status bar at the bottom shows the total context usage including all active documents. If documents push the context over the engine's budget, older conversation history is compacted automatically (NAE) or the most relevant chunks are selected (RLM).

## Related

<CardGroup cols={2}>
  <Card title="Supported Formats" icon="file" href="/features/document-context/supported-formats">
    Every format MIRA can parse
  </Card>

  <Card title="Document Chunking" icon="scissors" href="/features/document-context/document-chunking">
    How MIRA splits documents into context-sized pieces
  </Card>
</CardGroup>