StudioMediaPicker, native StudioFileUpload and FLEX Fields FileUpload store
a pinned assetId:versionId string. Multiple fields store an ordered array of
the same strings. Treat these as identifiers, not filesystem paths or URLs.
array. In the same
transaction as the owner record save, register and replace its usages.
Resolving or choosing an existing reference does not reupload the original.
Save a gallery with its usages
Register the owning model inmedia-studio.usage_owners, and route the
validated form state through the same transaction as the usage update. This
example assumes $campaign is the authorized owner, the model casts
gallery to an array, and $workspaceId was resolved server-side.
Deleted or unavailable media
Deleted Studio files are removed from the field selection when the form loads and again before validation/save. For example, if two of five selected assets are trashed in Studio, only the three available references remain; no broken preview tiles are rendered and saving does not fail because of those deleted references. This applies to native StudioFileUpload, its optional FLEX Fields adapter and StudioMediaPicker. Normal required/minimum-count rules still apply to the remaining selection. Workspace access or backend failures do not clear the selection. Removing a reference never reuploads or deletes another asset.Picker constraints and thumbnail conversions
Native StudioFileUpload, FlexFileUpload::mediaStudio() and StudioMediaPicker sharestudioThumbnailPreset(). Pass a preset name, a closure or null to use
Studio’s configured thumbnail role. The named rendition must already be generated
or registered in Studio. Opening a field never generates conversions or scans
storage. Missing thumbnails show file icons; originals are loaded only for an
explicit preview/download, never as a thumbnail fallback.