Media
What is Media?
Media are uploaded files (images and videos) stored in the Visual Experience Engine and used across scheduled content, assets, specification configurations, app logos, and more. They are the shared media library for an app or website.
Core Properties
| Property | Description |
|---|---|
| id | Firebase Storage object ID |
| name | File path (e.g. {appId}/folder/image.png) |
| url | Public download URL |
| contentType | MIME type (e.g. image/jpeg, video/mp4) |
| size | File size in bytes |
| createdAt | Upload timestamp |
| metadata | Optional (e.g. width, height for images) |
Storage Architecture
1. File Storage (Google Cloud Storage)
- Files are stored in Firebase Storage
- Path structure:
{tenantId?}/{appId}/{folderName?}/{filename} - Example:
palacio-production/promo-banners/hero.png - Folders (e.g.
promo-banners,trash) organize media per app
Supported File Types
Images
- PNG, JPEG, GIF, WebP, APNG, AVIF
- SVG
application/octet-stream(fallback)
Videos
- MP4, WebM, OGG
Media Gallery (UI)
The Media section in the Visual Experience Engine provides:
- Upload – Drag-and-drop or file picker for images and videos
- Folders – Organize media in folders per app
- Browse – Grid view of images and videos
- Preview – Full-size preview
- Edit – Rename, move, copy URL
- Delete – Move to trash (soft delete)
- Pagination – 40 items per page by default
How Media Are Used
| Context | Usage |
|---|---|
| Scheduled Content | Scheduled content images, video backgrounds, variant media |
| Assets | HTML asset with embedded images |
| Specification configuration | Config values of type image (URL) |
| App/Website logos | App and web switcher icons |
| Categories | Category images |
| Templates | Snippet/template preview images |
| User profile | Avatar image |
| Config | Localization files, images |
When creating scheduled content, picking assets, or configuring a layout, the MediaUploader or ContentPicker lets you choose from uploaded media (or upload new ones).
Image Metadata
For image uploads, the system:
- Fetches the image dimensions (width, height)
- Stores them in both Storage and RTDB metadata
- Uses them for responsive images, previews, and layout
Key Takeaway
Media are images and videos uploaded to the Visual Experience Engine and stored in Google Cloud Storage, with metadata in the Realtime Database. They are managed in the Media section (Media Gallery) and used across scheduled content, assets, specifications, logos, and other features. Each item has a public URL that can be referenced in assets and configuration.