Skip to main content
Use these Studio methods alongside the installed Filament component’s own schema and validation methods. Workspace IDs, folder IDs and upload policy come from your host application and Studio access checks.

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() and studioScopedFolder() 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() and configureStudioPickerUsing() control generation, thumbnail selection and picker presentation respectively. Generation can be disabled independently of displaying a ready thumbnail.
The FLEX adapter adds 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.