Selected files in Studio Media Picker
The field supports list and grid presentations. Users can switch between them without changing their selection. Set the initial layout when defining the field.layout('list') for rows with thumbnails, names and sizes. Grid view shows
square thumbnails and file-type illustrations. Reorder selected files by dragging
the handle or focusing it and using the arrow keys. The field stores the same
versioned Studio references in both layouts.
To enforce one layout, hide the switch with layoutSwitcher(false):
layout() and layoutSwitcher() accept a closure, including Filament
utility injection. The default layout is list and the switch is enabled.
Hiding the switch applies the configured layout to every selected file.
Download and custom file actions
Download buttons are optional and hidden by default. Usedownloadable(false)
to hide them explicitly, or a closure to control their visibility dynamically.
$file, resolved on
submission against the current selection and workspace access. Native action
injections such as $component, $arguments and $livewire remain available.
The pinned identity is also available in $arguments['mediaReference'].
Restrict a PDF field to a folder
Persist a nullable string for one file or cast the model attribute to array for
multiple files. References and picker behavior
explains cancellation, count validation, stale references and usage tracking.