FileUpload crashes on mobile when selecting multiple images

[enessvg]

Package

Form builder

Package Version

v4.

How can we help you?

Hi, I found an issue with FileUpload.

When selecting more than 6 images on mobile devices, the page crashes/freezes before upload completes. Desktop works without any issues. Since FileUpload uses FilePond internally, I’m not sure if this is a Filament issue or a FilePond limitation on mobile.

Has anyone experienced this?

[mg1986jp]

This is a known FilePond limitation on mobile, not Filament-specific. The issue is that when you select multiple images on mobile, FilePond tries to process them all simultaneously — each file gets read into memory via FileReader, resized (if image resize is enabled), and uploaded. On mobile browsers with limited memory, 6+ images at once triggers the browser's memory pressure kill or freezes the JS thread.

A couple of fixes:

1. Limit parallel uploads:

FileUpload::make('images')
    ->multiple()
    ->maxParallelUploads(2) // process 2 at a time instead of all at once

This maps to FilePond's maxParallelUploads option and is the most impactful change.

2. Disable image previews during upload (biggest memory saver on mobile):

FileUpload::make('images')
    ->multiple()
    ->maxParallelUploads(2)
    ->imagePreviewHeight(0) // or use ->previewable(false)

Mobile Safari and Chrome are especially aggressive about killing tabs that exceed ~300-400MB. Each image preview rendered in the DOM adds to that.

3. Set a max file size to prevent huge photos from being processed:

FileUpload::make('images')
    ->multiple()
    ->maxSize(5120) // 5MB per file
    ->maxParallelUploads(2)

If none of these help, the nuclear option is chunked uploads (->chunked() in Filament v4+), which processes files in smaller pieces and dramatically reduces peak memory.