Media Library

All your media in one place

The Media Library is where all uploaded files are stored and managed. Every image, video, and document uploaded through the content editor or directly is accessible here.

The library provides:

• A visual grid of all media files
• Search and filter by file type, name, or date
• File details including dimensions, size, and usage
• Bulk selection and actions

Images, videos, and files

Svalla supports multiple media types:

• IMAGE — JPG, PNG, WebP, GIF, SVG, and other common image formats
• VIDEO — MP4, WebM, and other video formats
• FILE — PDF, DOC, XLS, ZIP, and any other downloadable file
• External media — link to external images, videos (YouTube, Vimeo), or files hosted elsewhere

Each media type stores relevant metadata: images include dimensions (width, height), files include size, and all types support alt text for accessibility.

Automatic performance optimization

Svalla automatically optimizes images on upload to ensure your website loads fast:

• Compression — images are compressed without visible quality loss
• WebP conversion — modern format support for smaller file sizes
• BlurHash placeholders — a tiny blur preview is generated for each image, enabling smooth progressive loading on your frontend

The optimization runs in the background using Sharp, a high-performance image processing library. Original files are preserved alongside the optimized versions.

Scalable file storage with AWS S3

All media files are stored in AWS S3, providing:

• Scalability — no storage limits, files are served from cloud infrastructure
• Performance — fast delivery through AWS's global network
• Reliability — built-in redundancy and durability

File URLs are generated automatically and returned through the API with all necessary metadata (src, alt, dimensions, placeholder).

Using media in your pages

Media is used in content through Multimedia and Gallery fields in the Section Builder:

• Multimedia field — a single media upload (image, video, or file) with configurable accepted formats
• Gallery field — multiple images with drag-to-reorder

When a media file is uploaded in a section, the API returns the full media object including:

• href — the file URL
• placeholder — the BlurHash string for progressive loading
• alt — accessibility text
• width / height — dimensions for layout calculations
• type — the media type (IMAGE, VIDEO, FILE)