File Downloader

Last updated: May 22, 2026

The File Downloader module enables your app to download files from your website and save them to the device. When a user taps a download link inside the app, instead of opening the file in the browser, the app handles the download natively — showing progress, allowing minimization, and offering to open the file once complete.

iOS — Photo Library Permission

On iOS, if your app downloads images or videos to the Photos app, Apple requires you to include a usage description explaining why the app needs access.

  • Default: Allow access to photo library to allow the app to read and write files inside Photos.
  • Maximum length: 200 characters

This text appears in the iOS permission dialog when the app first requests Photos access. Keep it clear and accurate.

UI Labels

Customize every piece of text shown during the download flow.

LabelDefaultDescription
Downloading HeadlineFile DownloadingShown while the download is in progress
Download Completed HeadlineDownload CompletedShown when the file has been saved
Minimize ButtonMINIMIZEMinimizes the download dialog so the user can continue browsing
Cancel ButtonCANCELCancels an in-progress download
Close ButtonCLOSECloses the dialog after completion
Open ButtonOPEN FILEOpens the downloaded file

Colors

All color values support standard 6-digit HEX codes.

Background & Text

ElementLight ModeDark Mode
Background#f8f8f8#323035
File size text#333333#E0E0E0
Headline text#000000#ffffff

Progress Bar

ElementLight ModeDark Mode
Track background#999999#616161
Fill (progress value)#448AFF#448AFF

Button Text Colors

ButtonLight ModeDark Mode
Minimize#448AFF#448AFF
Cancel#FF5252#FF5252
Close#448AFF#448AFF
Open#259B24#69F0AE