> For the complete documentation index, see [llms.txt](https://docs.qyrus.com/device-farm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qyrus.com/device-farm/file-upload.md).

# File Upload Feature for Remote Real Devices

## 1. Introduction

The **File Upload** feature allows you to transfer files directly from your local computer into the local storage of a remote physical device during an active Device Farm session. This capability is essential for testing workflows that require local files, such as profile picture uploads, document scanning, test datasets (CSV/JSON), audio/video playback, and custom configuration files.

***

### Supported Platforms & Formats:

* **Supported Operating Systems:** Physical **Android** and **iOS** devices.
* **Supported File Formats:** Images (`.png`, `.jpg`, `.jpeg`, `.gif`), Documents (`.pdf`, `.docx`, `.txt`, `.csv`, `.json`), Media (`.mp4`, `.mp3`, `.wav`), and custom application data binaries.

***

## 2. Uploading Files During an Active Session

1. Start an active manual or Object Spy testing session on a target device [(learn more)](/device-farm/manual.md#creating-a-manual-device-session).
2. Locate the **File Upload** icon on the device control bar.
3. Click the button to open your operating system's file browser.
4. Select the file you wish to push to the remote device.
5. The button displays an upload spinner while the file is streamed securely to the device. A success notification confirms when the transfer completes.

***

### Platform-Specific Storage Locations:

#### **iOS Devices:**

Uploaded files are stored within the sandbox directory accessible by file-picker dialogues:

* **Location:** `Files App > On My iPhone > Chrome`

![iOS File Upload Flow](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-fe019d1de437ca112e4e2babe3f8a1263be13b5b%2Ffileupload.gif?alt=media)

***

#### **Android Devices:**

Uploaded files are stored directly in the standard system download folder:

* **Location:** `Internal Storage > Downloads` (or `/sdcard/Download/`)

![Android File Upload Flow](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-cc0b461e527cc0005a3751f7427356ab9c13cc22%2Ffileupload-android.gif?alt=media)

***

## 3. Verifying the Uploaded File on the Device

Once the transfer is complete, you can verify and access the file within your application:

* **On iOS:** Open the native **Files** app, navigate to **On My iPhone**, and open the **Chrome** folder.
* **On Android:** Open the native **Files** / **My Files** app or launch your app's file picker and select the **Downloads** directory.

***