Skip to main content

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.
Use 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):
Both 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. Use downloadable(false) to hide them explicitly, or a closure to control their visibility dynamically.
Custom actions appear beside each selected file in both layouts. Native Filament action configuration controls their icon, label, visibility, disabled state, confirmation and modal schema. Closure handlers receive $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.