1
Open the Media Library
Trigger it from any image picker — for example, an Image widget’s source or a branding logo control.
2
Switch to the Upload tab
The modal has a Library tab and an Upload tab. Open Upload.
3
Add files
Drag images onto the drop-zone or click to open the file picker. You can select multiple files at once.
4
Upload
Click Upload files. Each file uploads in parallel, then appears in the Library tab.
Supported files
The Upload tab accepts images only: JPEG, PNG, GIF, SVG, and WebP.Limits
- Up to 25 MB per file.
- Up to 10 files per upload batch.
API
The upload flow is two steps.POST /v1/media/presigned-url (send file_name, content_type, and size) creates the media row and returns an upload_url, the S3 key, and the new media_id. Upload the file with an HTTP PUT to upload_url, then confirm the display name with PUT /v1/media/{id}.