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
Start an active manual or Object Spy testing session on a target device (learn more).
Locate the File Upload icon on the device control bar.
Click the button to open your operating system's file browser.
Select the file you wish to push to the remote device.
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

Android Devices:
Uploaded files are stored directly in the standard system download folder:
Location:
Internal Storage > Downloads(or/sdcard/Download/)

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.
Last updated