Upload Issues

Troubleshooting file upload problems.

Upload Failures

File Not Uploading

Check:

Storage limit not exceeded
File size within max upload size (admin-configurable in Settings → Storage)
Network connection stable
Bucket available and within provider limits

Storage Limit

Solutions:

Check current storage usage
Delete unnecessary files
Empty trash
Admin: Increase storage limit

File Too Large

The file exceeds the max upload size setting.

Solutions:

Check the current max upload size in Settings → Storage
Admin: Increase the max upload size
Split the file into smaller parts

Upload Errors

"Storage limit exceeded"

Solutions:

Free up storage space
Delete old files
Empty trash permanently
Admin: Increase storage limit (if custom limit set)
Check the bucket provider quota and account status

"Upload failed"

Check:

File size limits
Bucket endpoint and credentials
Bucket access permissions
Network connectivity

"Upload cancelled by client" (499 REQUEST_ABORTED)

Returned when the user cancels an upload. The request is aborted before completion. The upload middleware aborts incomplete multipart uploads and cleans up uncommitted bucket objects. This is expected behavior, not an error

Folder uploads missing files

Confirm the browser supports folder upload (Chrome, Edge, and other Chromium-based browsers)
Check that the selected folder actually contains the missing files (some apps create links or placeholders that are not real files)
Look in Audit Logs for file.upload.bulk events to see how many files were processed.
If only some files failed, check the failed entries returned by POST /api/files/upload/bulk

File Permissions

Permission Denied

Solutions:

Check that the configured bucket credentials allow uploads and deletion
Verify the user has upload permission
Check bucket policies and endpoint reachability
Review backend logs for the provider error

Common Errors - General troubleshooting
Files API - Upload endpoints
Storage Management - Storage concepts

On this page