Selected media fields
See StudioMediaPicker for ordered galleries and
custom item actions. Action callbacks can receive the authorized
mediaReference from the current selection.
Upload fields
StudioFileUpload uses native Filament. FlexFileUpload::mediaStudio() uses the optional FLEX Fields presentation. Both support the shared configuration.studio()takes workspace, module and optional stylesheet URL, optional upload folder and MIME types, and boolean defaults for library selection and rendition generation. It configures the Studio destination independently of Filament’s native upload storage.studioUpload(),studioLibrarySelection(),studioUploadFolder(),studioBrowseFolder()andstudioScopedFolder()control upload and browse scope. Explicit upload and browse folders must satisfy the configured subtree.persistStudioUploadsImmediately()accepts a boolean or closure. Native StudioFileUpload publishes on form save by default. FLEX publishes completed, admitted uploads immediately by default. Both keep selection state as pinned references.studioGenerateRenditions(),studioThumbnailPreset()andconfigureStudioPickerUsing()control generation, thumbnail selection and picker presentation respectively. Generation can be disabled independently of displaying a ready thumbnail.
studioImageEditor(), studioAiImageEditor() and
studioInlineEditedThumbnail() for application-owned image version
publication. deleteReplacedFiles() passes the field’s replacement policy to
the classic publisher. An AI publisher reads it through
shouldDeleteReplacedFiles(). Configure both callbacks and use the same
publisher when they should share policy. See
thumbnail generation after edits
and version history.
Custom action picker
StudioPicker is a low-level field for an application-owned action.
studio() accepts one ULID or an explicit list of up to 20 workspaces.
acceptedMimeTypes(), allowUpload() and folders() define its browsing
and upload options. selectionLimit() enables multi-selection and bounds it
to 1–120. selectedReferences() seeds pinned references. thumbnailPreset()
and selectionMessage() configure thumbnails and validation copy.
studioOptions() accepts the following serializable presentation keys.
layout, locale, localization, browse, comments,
pdfPreview, documentPreview, imagePreview, videoEditing,
previewActions, previewMenu, previewTitleEditable,
videoPreviewSkin, primaryColor and branding.
Use the dedicated methods for workspace, scope, MIME and upload constraints.
See custom picker setup for submit validation and
the single-file selection resolver.
Editors and displays
Default editor MIME types are JPEG, PNG, WebP, AVIF and GIF. Editor insertion
still requires a supported inline image. Restrict the list for your use case
and disable uploads with
allowUpload: false when editors should use only
existing media.