-
Notifications
You must be signed in to change notification settings - Fork 0
Media Library
The media library stores all uploaded images and files. Access it via Media in the admin sidebar.
Click Upload and select files. Multiple files can be uploaded at once. Supported image formats: JPEG, PNG, GIF, WebP, SVG. Maximum file size: 10 MB for images, 50 MB for other files.
Organize media with folders. Click New Folder to create a folder. Folders can be renamed and deleted (deleting a folder does not delete its files).
Image and file fields open a media picker when you click the field. Browse folders, search by filename, and select the desired file.
For image fields, you can set a focal point — the most important area of the image. When Marble generates a cropped version, it centers the crop on the focal point.
To set: click Set Focal Point on the image in the media library, then click the focal area on the image preview.
Images served via $media->url(width, height) are resized on the fly:
$img->url() // Original — no resizing
$img->url(800) // Resize to width 800, proportional height
$img->url(0, 400) // Resize to height 400, proportional width
$img->url(800, 600) // Cover-crop to 800×600 (uses focal point)When editing a rich text field, the image upload button in CKEditor uploads directly to the media library.
Click the trash icon on a media item. Note: deleting media that is still referenced by content items will leave broken image references — check usage before deleting.