Main component error codes
Whenever an internal error occurs within the main File Uploader component, the onErrorAction
callback is triggered. This callback provides two parameters:

errorCode
ā the type of error that occurred.fileName
ā the name of the file that caused the error.
These values are available under:
ā Callback Parameters > errorCode
ā Callback Parameters > fileName
You can use them to create a custom error-handling flow, display messages in your preferred language, and inform the user through:
A modal or snackbar
Navigation to another page
Conditional flows depending on the error type
Anything you can imagine!
ā ļø Note: If an error occurs but
onErrorAction
is not triggered, it likely means the error happened outside the component's scope (e.g., a file was dropped outside the dropzone area and was never detected).
š§¾ Complete List of Error Codes
UPLOAD_DISABLED
UPLOAD_DISABLED
Meaning: File uploading is fully disabled. This happens when:
maxFileCount <= 0
, orexistingFileCount >= maxFileCount
No new files can be added.
TOO_MANY_FILES
TOO_MANY_FILES
Meaning:
The user tries to upload more files than allowed.
Example:
If maxFileCount = 5
and existingFileCount = 4
, attempting to add 2 more files will trigger this error (4 + 2 = 6 exceeds the limit).
GENERAL_ERROR
GENERAL_ERROR
Meaning: A generic or uncategorized error. Possible causes:
On iOS: No valid file formats available for the picker.
On desktop or mobile: Temporary file storage failed.
FILE_PICKER_ERROR
FILE_PICKER_ERROR
Meaning: There was a problem during file selection using the FilePicker. Common reasons:
User canceled the picker unexpectedly.
Internal picker failure.
DROPZONE_ERROR
DROPZONE_ERROR
Meaning: An issue occurred in the drag-and-drop process. Possible causes:
Dropzone controller wasn't ready.
Invalid data was dropped (e.g., plain text instead of a file).
Failure during processing of the dropped file.
FILE_TOO_LARGE
FILE_TOO_LARGE
Meaning:
The file exceeds the maximum size allowed, based on maxFileSizeKb
.
UNSUPPORTED_FILE_TYPE
UNSUPPORTED_FILE_TYPE
Meaning:
The file type is not allowed according to the allowedFormats
or blockedFormats
configuration.
FILE_BYTES_UNAVAILABLE
FILE_BYTES_UNAVAILABLE
Meaning: The byte data for the selected or dropped file could not be accessed.
INVALID_URL
INVALID_URL
Meaning: A file upload attempt via URL failed because the URL is empty or invalid.
DOWNLOAD_FAILED
DOWNLOAD_FAILED
Meaning: The file could not be downloaded from the given URL. Possible causes:
Network failure
HTTP status code other than 200
Any error during the download process
CORS error. See docs.
EMPTY_FILE
EMPTY_FILE
Meaning: The file downloaded from the URL contains no data (0 bytes).
Last updated