File Uploader Native Mobile

✅

Link to the plugin page: https://zeroqode.com/plugin/file-uploader-native-mobile-1748584747630x119879954718316480

Demo to preview the plugin:

✅

Live Demo: https://zeroqode-native-demo-03.bubbleapps.io/api/1.1/mobile/preview?debug_mode=true&preview_view=Uploade

✅

Bubble Editor: https://bubble.io/page?id=zeroqode-native-demo-03&test_plugin=1745565872934x948179487944605700_current&tab=Design&name=Uploade&type=page&version=live

Introduction

This plugin offers a simple and user-friendly solution to add file uploading capabilities to your Bubble Native (mobile) app. By placing the Native File Uploader element on your page, you enable users to upload files easily without any coding. Customize the look and feel of the uploader to perfectly blend with your app’s design, while giving users a reliable way to upload various file formats. Featuring live progress updates and comprehensive control over upload actions, this plugin provides an efficient way to improve your app’s file upload functionality with minimal setup.

Prerequisites

This plugin is designed specifically for the mobile version of the Bubble editor. To test the plugin on your mobile device, use the TestFlight app available at: https://testflight.apple.com/join/VykzdCs6

⚠️

Please note that the testing app is currently available for iOS only.

How to Use (Step by Step)

💡

Font Customization Limitation

At the moment, it is not possible to use custom font families in Bubble Native apps.

Only system fonts are supported.

💡

Limitation in Bubble Native apps

Currently, it's not possible to open the device's native file manager to manually select non-media files (such as PDF, DOCX, TXT, ZIP).

This is a limitation of the React Native environment provided by Bubble.

💡

Note for iOS users

In React Native apps, iOS automatically converts HEIC images to JPEG.

So even if the original photo is in HEIC format, it will already be sent as a JPEG — no extra conversion is needed.

⚠️

Note about permissions

For the plugin to work, you must enable file and photo permissions in the app settings on your phone.

Native Uploader

The Native Uploader element is a user interface component designed for Bubble Native apps, allowing users to upload media files directly from their mobile device’s gallery. It supports both single and multiple file selection, displays real-time upload statuses, and includes customizable labels, messages, and styles. Ideal for apps that require image or video submissions in a native environment.

Fields

Field	Description	Type
endpoint	Upload endpoint URL where files will be sent (e.g. Bubble `/fileupload` or custom API endpoint).	Text
Allow Multiple	Allows selecting multiple files at once from the device gallery.	Yes/No
Max File Count	Maximum number of files allowed per upload session.	Number
Max Total Upload Size MB	Maximum total size (in MB) of all selected files combined.	Number
Label Title	Title displayed at the top of the uploader element.	Text
Label Button	Label displayed on the upload button.	Text
Message Uploading	Message shown during upload. Supports `{count}` placeholder.	Text
Message Success	Message displayed when upload is successful.	Text
Message Error	Message displayed when upload fails.	Text
Message Cancelled	Message shown when user cancels file selection.	Text
Message Empty	Message shown when no valid files are selected.	Text
Message Limit Exceeded	Message shown when file count exceeds limit. Supports `{maxCount}` placeholder.	Text
Message Size Exceeded	Message shown when total file size exceeds limit. Supports `{totalSize}` and `{maxTotalSize}` placeholders.	Text
Button Content Mode	Controls button content: `text`, `icon`, or `icon_text`.	Dropdown
Icon Size X	ontrols the width of the image used as the button icon.	Number
Icon Size Y	Controls the height of the image used as the button icon.	Number
Button Icon	Image/icon displayed on the button (used in icon modes).	Image
Button Background Color	Background color of the upload button.	Color
Button Text Color	Color of the button text.	Color
Button Font Size	Font size of the button text.	Number
Button Border Radius	Radius of button corners.	Number
Button Border Color	Border color of the button.	Color
Button Border Width	Border width of the button.	Number
Button Border Style	Border style: solid, dashed, or dotted.	Dropdown
Button Text Bold	Displays button text in bold.	Yes/No
Button Text Italic	Displays button text in italic.	Yes/No
Button Text Underline	Underlines the button text.	Yes/No
Status Background Info	Background color for informational status messages.	Color
Status Background Success	Background color for success messages.	Color
Status Background Error	Background color for error messages.	Color
Status Text Color Info	Text color for informational messages.	Color
Status Text Color Success	Text color for success messages.	Color
Status Text Color Error	Text color for error messages.	Color
Status Text Size	Font size of the status message text.	Number
Status Text Weight	Font weight of the status text (normal, bold, etc.).	Dropdown
Status Text Style	Font style of the status text (normal or italic).	Dropdown

State	Description	Type
Uploaded File Url	Returns the latest uploaded file URL.	Text
Uploaded File Urls List	List of all uploaded file URLs.	List of Text
Deleted File Url	URL of the file removed from the preview (can be used for cleanup).	Text
Upload Status Text	Current upload status message (e.g. Uploading, Success, Error).	Text
Upload Progress	Global upload progress (0 to 100)	Number
Current File Name	Name of the file currently being processed.	Text
All File Names List	List of all uploaded file names.	List of Text
Current File Size	Size of the current file (in MB).	Number
All File Sizes List	List of all uploaded file sizes.	List of Number
Current File Type	MIME type of the current file.	Text
All File Types List	List of all uploaded file types.	List of Text

Event	Description
Upload Started	Triggered when the upload process begins.
Upload Finished	Triggered ONCE PER SUCCESSFUL FILE during the upload loop, symmetric to 'Upload Failed'. If 3 files succeed in a batch, this fires 3 times — use current_file_name to identify which file just finished. Use 'All Files Uploaded' if you need a single end-of-batch event
Upload Failed	Triggered when the upload process fails. ⚠️ Not always triggered depending on implementation.
Upload Empty	Triggered when no file is selected. ⚠️ Not always triggered depending on implementation.
Upload Canceled	Triggered when the user cancels file selection.
Upload Denied	Triggered when permission to access media is denied. ⚠️ Not always triggered depending on implementation.
All Files Uploaded	Triggered when all selected files have been successfully uploaded.
File Removed	Triggered when a file is deleted from preview or list
Upload Limit Exceeded	Triggered when file count limit is exceeded
Upload Size Exceeded	Triggered when total file size limit is exceeded

File Uploader Native Mobile

Demo to preview the plugin:

Introduction

Prerequisites

How to Use (Step by Step)

Native Uploader

Fields

Element States

Element Event

Changelogs

Update 13.05.26 - Version 1.20.0

Update 31.03.26 - Version 1.19.0

Update 06.03.26 - Version 1.18.0

Update 30.01.26 - Version 1.17.0

Update 21.01.26 - Version 1.16.0

Update 19.12.25 - Version 1.15.0

Update 11.12.25 - Version 1.14.0

Update 02.12.25 - Version 1.13.0

Update 01.12.25 - Version 1.12.0

Update 01.12.25 - Version 1.11.0

Update 14.11.25 - Version 1.10.0

Update 21.07.25 - Version 1.9.0

Update 14.07.25 - Version 1.8.0

Update 02.07.25 - Version 1.7.0

Update 06.06.25 - Version 1.6.0

Update 04.06.25 - Version 1.5.0

Update 02.06.25 - Version 1.4.0

Update 02.06.25 - Version 1.3.0

Update 02.06.25 - Version 1.2.0

Update 30.05.25 - Version 1.1.0

Update 29.05.25 - Version 1.0.0