Media Library
The media library is a centralized system for managing all uploaded files — product images, brand logos, banners, documents, and more.
Media Folders
Media is organized into folders. Each folder has a name and a slug that determines the URL path:
| Folder | Slug | Usage |
|---|---|---|
| Product Images | product-images | Product variant photos |
| Brand Logos | brand-logos | Brand logo images |
| Banners | banners | Promotional banners |
| Documents | documents | PDF, DOCX files |
Managing Folders
Navigate to Content → Media. Create, rename, or delete folders from the folder tree on the left.
Uploading Files
- Select a folder
- Click Upload or drag-and-drop files
- Files are uploaded and stored in the configured storage backend
Supported Formats
Images: JPG, JPEG, PNG, GIF, WebP, SVG, BMP, TIFF Videos: MP4, WebM, OGG, MOV, AVI Audio: MP3, WAV Documents: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT, CSV Archives: ZIP, RAR, 7Z, GZ
Size Limit
Maximum file size: 50 MB (configurable in Storage.MaxFileSizeMB).
Storage Backends
The media system supports three storage providers (configured by the system admin):
| Provider | Description |
|---|---|
| Local | Files stored on the API server's filesystem (wwwroot/media/) |
| Network Share | UNC path to a network storage location |
| S3 | Amazon S3 or compatible object storage |
The active provider is transparent to Backoffice users — uploading and browsing works the same regardless.
Using Media in Products
When editing a product variant, upload or select images from the media library. Images are linked to variants (not products), allowing different photos per color variant.
Derived Assets
The system can generate derived assets (thumbnails, WebP conversions) from uploaded images. These appear alongside the original in the media detail view.
Keep your media library organized with consistent folder structure. Use descriptive filenames — they become part of the public URL.