By default, file input elements (<input type="file">) in a WebView do not open a file picker. Without explicit file upload support, users who try to upload a photo, attach a document, or submit a file form will see nothing happen: the button tap doesn't respond.
Enabling file upload support is required for any feature on your website that asks users to provide a file. This is a Professional build feature.
What File Upload Enables
- Profile photo upload
- Document attachment in forms
- Image submission for reviews or support tickets
- File-based onboarding (e.g., ID verification, resume upload)
- Any
<input type="file">element on your website
How to Enable It
- In your app configuration, go to Permissions
- Enable File Upload: this requests
READ_EXTERNAL_STORAGEand configures the WebView's file chooser callback - If you also need camera for direct photo capture (not just gallery selection), enable Camera
- Save your configuration and run a new Professional build
Permissions Required
File upload on Android involves two Android permissions depending on OS version:
- Android 12 and below:
READ_EXTERNAL_STORAGEis required to access files from the device's storage - Android 13+: Granular media permissions (
READ_MEDIA_IMAGES,READ_MEDIA_VIDEO,READ_MEDIA_AUDIO) replace the old storage permission. WebToAppConvert requests the appropriate permissions based on Android OS version automatically.
When a user first taps a file upload button, Android will prompt them to grant the relevant permission. If they deny it, the file picker will not open. Users can grant the permission later from the device's app settings under Settings → Apps → [Your App] → Permissions.
Camera Access for File Upload
When file upload is enabled and a user taps a file input, Android presents a chooser with options including the gallery and camera (if camera permission is granted). This lets users take a new photo directly rather than selecting an existing one: useful for profile photos, receipt capture, and other scenarios where live capture makes sense.
To enable camera as a source for file upload, enable the Camera permission in addition to File Upload.
File Download
File upload and file download are separate capabilities. File download (saving files from the app to device storage) is configured separately under File Download in permissions. See Understanding App Builds and Credits for a full breakdown of what each permission covers.
Testing File Upload
Test with a Debug build before your production build:
- Install the debug APK on a real Android device (not an emulator: file picker behavior can differ)
- Navigate to a page on your website with a file input
- Tap the file input and confirm the system file picker appears
- Select a file and confirm it appears in the form / uploads correctly
- If camera is enabled, confirm the camera option appears in the chooser