Native File Upload — Usage Instructions 1. Add the element

Drag the Native File Upload element onto any page or reusable element. It works the same way on web and on native BubbleGo builds — no separate setup needed.

2. Required setup for mobile (BubbleGo)

To make uploads work on native mobile builds, set the app_url property with your app's URL, including the version:

https://yourapp.bubbleapps.io/version-live

or, for testing on the development version:

https://yourapp.bubbleapps.io/version-test

Without this, uploads on web will still work normally, but native mobile uploads may fail to find the correct endpoint.

3. Element properties
Property Type Description
app_url text Your app's base URL (required for mobile uploads)
allow_multiple yes/no Allow selecting more than one file at once
max_files number Maximum number of files allowed (default: 5)
max_file_size_mb number Maximum size per file, in MB (default: 10)
accepted_file_types text Comma-separated MIME types or extensions (e.g. image/*,application/pdf). Leave empty to accept any file
button_text text Custom label for the upload button
remove_text text Custom label for the remove button
remove_all_text text Custom label for the "remove all" button
show_file_list yes/no Show the list of selected files
show_file_icons yes/no Show file-type icons for non-image files
show_image_preview yes/no Show inline previews for images/videos/PDFs
show_remove_all_button yes/no Show a button to clear all files at once
primary_color text (hex) Main accent color (button, progress bar)
button_text_color text (hex) Text color on the upload button
background_color text (hex) Element background color
border_color text (hex) Border color
progress_background_color text (hex) Background of the progress bar track
progress_bar_color text (hex) Progress bar fill color
theme text light or dark
language text en, pt, or es
is_disabled yes/no Disable the element (no interaction)

4. States you can use in workflows
State Type Description
file_names list of texts Names of all selected files
file_types list of texts MIME types of all selected files
file_sizes list of numbers Sizes (bytes) of all selected files
uploaded_file_urls list of texts URLs of successfully uploaded files
selected_file_name text Name of the most recently processed file
selected_file_type text Type of the most recently processed file
selected_file_size number Size of the most recently processed file
selected_file_url text URL of the most recently uploaded file
uploaded_file_url text Same as above (alias, kept for compatibility)
selected_file_base64 text Base64 data of the last file (web only)
file_base64_list list of texts Base64 data for all files (web only)
files_count number Total number of files currently selected
has_files yes/no Whether any file is selected
upload_progress number Upload progress percentage (0–100)
is_uploading yes/no Whether an upload is currently in progress
is_uploaded yes/no Whether the last batch finished uploading successfully
upload_error text Error message, if any

Note: on native mobile, base64 states are intentionally left empty — the file URI is uploaded directly for performance. Use uploaded_file_urls on mobile instead of the base64 states.

5. Events you can trigger workflows on
Event Fires when
upload_started The upload process begins
file_selected A single file finishes uploading
files_selected The full batch finishes uploading
upload_finished The full batch finishes (same trigger point as files_selected)
file_removed A file is removed (individually or via "remove all")
upload_error Any error occurs (size limit, file count limit, network failure, etc.)

6. Typical workflow example
User taps the upload button and selects files.
upload_started fires — show a loading state if you want.
As each file finishes, file_selected fires — you can react per file if needed.
When everything is done, files_selected / upload_finished fires.
Use Element Native File Upload's uploaded_file_urls to save the links to your database (e.g. in a "Make changes to thing" or "Create a new thing" action).

7. Troubleshooting
Uploads fail only on mobile / BubbleGo: double-check the app_url field matches your app's actual URL and version.
Only one file uploads when selecting several of the same type: make sure allow_multiple is set to yes on the element instance.
File too large / too many files: check max_file_size_mb and max_files — the plugin blocks the whole batch if either limit is exceeded, and reports it via upload_error.