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

Meaning: File uploading is fully disabled. This happens when:

  • maxFileCount <= 0, or

  • existingFileCount >= maxFileCount

No new files can be added.


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

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

Meaning: There was a problem during file selection using the FilePicker. Common reasons:

  • User canceled the picker unexpectedly.

  • Internal picker failure.


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

Meaning: The file exceeds the maximum size allowed, based on maxFileSizeKb.


UNSUPPORTED_FILE_TYPE

Meaning: The file type is not allowed according to the allowedFormats or blockedFormats configuration.


FILE_BYTES_UNAVAILABLE

Meaning: The byte data for the selected or dropped file could not be accessed.


INVALID_URL

Meaning: A file upload attempt via URL failed because the URL is empty or invalid.


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

Meaning: The file downloaded from the URL contains no data (0 bytes).

Last updated