> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.cloudraker.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.cloudraker.com/_mcp/server.

# Files in a space

The **Files** tab is a space's file pool: a single **flat table** — no folders, no tags. Every file you upload lives here, alongside files that runs and actions generate.

## Uploading files

Add files two ways:

* Click **Upload files** and pick them.
* **Drag and drop** files onto the panel. An overlay appears — "Drop files to upload" / "Release to add them to this space."

A placeholder row shows while an upload is in flight.

## The table

Each file is a row with these columns:

| Column       | What it shows                                                                 |
| ------------ | ----------------------------------------------------------------------------- |
| **Name**     | The file name, with a type icon and size. Click it to open the detail drawer. |
| **Uploaded** | When the file was added.                                                      |
| **Actions**  | Per-row **Download** and **Delete**.                                          |

Filter the list with the **Search by file name** box. Select one or more files to reveal a **bulk toolbar** with **Run action**, **Download**, **Delete**, and **Clear**. **Run action** launches a single-action run over the selected files — see [Run an action](/actions/run-an-action).

## Processing states

After upload, each file moves through processing, shown as a status badge:

**Uploading → Stored → Processing → Processed**

A file that can't be processed shows **Failed**. Download stays disabled while a file is still **Uploading**.

Processing automatically indexes each file for the **Search** tab and, for documents, builds the space's **Graph** — no per-file toggle. See [Search and the knowledge graph](/spaces/search-and-graph).

## The file detail drawer

Click a file name to open its drawer. It shows the filename, a type badge, a status badge, the size and date, and a **Download** button. What you can preview depends on the type:

#### PDFs

PDFs preview inline in an embedded viewer.

#### Images

Images render inline.

#### Audio

Audio files get a player with a **synced transcript**. The segment under the playhead is highlighted and auto-scrolls; click any segment to seek the player to it. Speakers are labeled **Speaker N** with `mm:ss` timecodes.

#### Other file types

"Preview isn't available for this file type. Download the file to review it."

If a file **Failed**, the drawer shows "Processing failed" and a **Try processing again** button to retry.

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/cloudraker.docs.buildwithfern.com/bd5ceeb5609c9f1ec721edcbc49bb19207833d15506c3756aba5ca8401ed5d97/docs/assets/images/guide/spaces/files-drawer.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260726%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260726T051229Z&X-Amz-Expires=604800&X-Amz-Signature=31060008c98e8c2473e09e8b09f1625d1c5c1da13853241d57260f2c21bfe52c&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" alt="The Files tab table with a file drawer open, showing the PDF badge, Processed status, Download button, and an inline invoice preview" />

Need programmatic access to files and their parsed output? See the [Developers](/developers/overview) tab.