> 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 the space's file pool. It is one **flat table** with no folders and no tags. It holds every file you upload. It also holds the files that runs and actions generate.

## Uploading files

Add files in two ways:

* Click **Upload files** and select the files.
* **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 progress.

## The table

Each file shows as 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** | The date the file was added.                                                  |
| **Actions**  | Per-row **Download** and **Delete**.                                          |

Use the **Search by file name** box to filter the list. Select one or more files to show a **bulk toolbar**. The toolbar has **Run action**, **Download**, **Delete**, and **Clear**. **Run action** starts a single-action run on the selected files. See [Run an action](/workspace/actions/run-an-action).

## Processing states

After upload, each file moves through processing. A status badge shows the state:

**Uploading → Stored → Processing → Processed**

A file that cannot be processed shows **Failed**. Download stays disabled while a file is **Uploading**.

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

## The file detail drawer

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

#### PDFs

PDFs show inline in an embedded viewer.

#### Images

Images show inline.

#### Audio

Audio files get a player with a **synced transcript**. The transcript highlights the segment under the playhead and scrolls to it. Click a segment to move the player to it. Speakers show as **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 shows **Failed**, the drawer shows "Processing failed" and a **Try processing again** button. Click the 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%2F20260826%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260826T020353Z&X-Amz-Expires=604800&X-Amz-Signature=1546ff07e5cae3226054f41211324b979a75955ac964dd6dabf2d0d7e6af4277&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" />

For programmatic access to files and their parsed output, see the [Developers](/paperwork/developers/overview) tab.