Media Library

Media Library

Every binary asset in the platform — product images, banners, blog images, documents, avatars — is stored and served through the Gallery module's central media library, not scattered across individual modules.

Uploading Media

Upload directly from the Gallery section in the sidebar, or from any image picker inside another module's form (e.g., a product's image tab) — either path stores the file in the same underlying library.

Automatic Optimization

Images are optimized and thumbnailed automatically in the background after upload, so large source files never slow down page loads. Multiple thumbnail sizes are generated for responsive rendering.

Access Levels

Each asset has an access level — public (anyone with the URL), protected (requires a valid signed URL), or private (authenticated + authorized access only). Use protected or private for sensitive documents (e.g., HRM employee files).

Attaching Media to Records

Media attaches polymorphically to any model that supports it — a product can have a gallery of images, a blog post a featured image, an HRM record a document. Reuse the same uploaded file across multiple records instead of re-uploading it.

AI Image Tools

Generate new images from a text prompt, or improve an existing image (upscale, background removal, style adjustment), directly from the media picker — usage is metered against your AI token quota.

Storage Disks

Configure where files are stored — local public disk, private disk, or an S3-compatible bucket — under Settings → Filesystems. Changing the disk does not require re-uploading existing files.