Name | Description | Type |
endpoint | Upload endpoint URL (e.g. Bubble's /fileupload). | Text |
Allow Multiple | Whether multiple file selection is allowed. | yes/no |
Max File Count | Maximum number of images allowed per selection. | Number |
Max Total Upload Size MB | Maximum total file size (in MB) allowed per upload. | Number |
Picker Source | Controls which file picker opens when the upload button is pressed: “Both” choice shows a modal with both options, “Gallery” opens the photo library directly, or “File manager” opens the document picker directly. | Text |
Auto Reset Uploader | When enabled, the uploader will automatically clear all internal data (images, status messages, progress bar) 2 seconds after a successful upload. This returns the element to its initial "Select files" state. | yes/no |
Hide File Previews | When enabled, the element will not display the built-in list of thumbnails or file names below the upload button. The upload process, progress bar, and status messages will still be visible. | yes/no |
Label Title | Title text shown at the top of the UI (e.g. “Upload your gallery photos”). | Text |
Label Button | Button label (e.g. “Select from gallery”). | Text |
Message Uploading | Message shown during uploading. Use the '{count}' text key to display the count of files being uploaded. | Text |
Message Success | Message shown on successful upload. | Text |
Message Error | Message shown on upload failure. | Text |
Message Cancelled | Message shown when selection is cancelled. | Text |
Message Empty | Message shown when no images were selected. | Text |
Message Limit Exceeded | Message shown when max file count is exceeded. Use the '{maxCount}' text key to display the max count of files allowed. | Text |
Message Size Exceeded | Message shown when max total size is exceeded. Use the '{totalSize}' text key to display the total size of files being uploaded. Use the '{maxTotalSize}' text key to display max total size allowed. | Text |
Button Content Mode | Defines the content mode for the button's display. | Text |
Button Icon PNG&JPEG | Image displayed on the button when Button Content Mode is set to pictures. | Image |
Icon Size Width | Controls the text color of the alert message. | Number |
Icon Size Height | Controls the font style of the alert text. | Number |
Button Background Color | Hex value of button background color (e.g. #1AAFD0). | Text |
Button Border Radius | Radius of the button’s corners (e.g. 8). | Number |
Button Text Bold | Specifies whether the button text should be bold. | yes/no |
Button Text Color | Hex value of button text color (e.g. #FFFFFF). | Text |
Button Font Size | Font size of the button label text (e.g. 24). | Number |
Button Text Italic | Specifies whether the button text should be italic. | yes/no |
Button Text Underline | Specifies whether the button text should be underlined. | yes/no |
Show Notifications | Controls the visibility of notifications. | yes/no |
Status Bg Color Info | Sets the background color for informational status messages. | Text |
Status Text Color Info | Defines the text color for informational status messages. | Text |
Status Bg Color Success | Sets the background color for successful status messages. | Text |
Status Text Color Success | Defines the text color for successful status messages. | Text |
Status Bg Color Error | Sets the background color for error status messages. | Text |
Status Text Color Error | Defines the text color for error status messages. | Text |
Status Text Size | Controls the font size of the alert text. | Number |
Status Text Weight | Controls the font weight of the alert text. | Text |
Icon Color | Icon Color input used by this action. | Color |
| 📄 Image Optimization | |
Optimize images | Enable automatic image optimization before upload. When active, images are resized and compressed to reduce file size. | yes/no |
Image max dimension | Maximum width or height in pixels. Images exceeding this value will be proportionally resized down. Has no effect if Optimize Images is disabled. | Number |
Compression quality | JPEG compression quality from 0 to 1. Lower values produce smaller files with reduced quality. Has no effect if Optimize Images is disabled. | Number |
Output format | Output format for optimized images.
JPEG — smaller file size, best for photos.
PNG — lossless, best for graphics with transparency (note: compress parameter has no effect on PNG).
WebP — best compression, supported on Android and iOS 14+.
If the original format cannot be preserved, JPEG is used as fallback.
Has no effect if Optimize Images is disabled | Dropdown |
| Progress Bar | |
Show | Show progress bar | yes/no |
Color | Color of the progress bar | Color |
