Portal Media
Portal Media is a file manager for uploading and organising images and media files used across your captive portal templates. Files uploaded here are available directly in the Portal Designer, ensuring your visual assets are always accessible and consistently managed in one place.
'alt' => 'Dashboard overview', 'caption' => 'The default Kiwire dashboard layout', 'screenshot' => true, 'class' => '', ]) Drop images into: public/assets/img/docs/{page}/{filename} --}}public/assets/img/docs/portal-media/overview.png
File Browser
The file browser displays uploaded media in a responsive thumbnail grid. Each file card shows:
- Thumbnail preview — rendered inline for images; a file-type icon for video files
- Filename — the original uploaded filename
- File size — shown in KB or MB
- Upload date — when the file was added
- Copy URL — a button to copy the public file URL to the clipboard
- Delete — remove the file (see warnings below)
Use the search bar to filter by filename, or use the type filter to show only images or only videos.
Supported File Types
| Format | Type | Notes |
|---|---|---|
PNG | Image | Preferred for logos and graphics with transparency |
JPG / JPEG | Image | Best for photographs; smaller file sizes |
GIF | Image | Supports animation; use sparingly for performance |
SVG | Image | Vector format; scales perfectly at any size |
MP4 | Video | For video embed elements in portal templates; H.264 codec recommended |
Maximum individual file size is enforced at the server level (typically 10 MB). For video files, consider keeping MP4 files under 5 MB to avoid long load times for guests on slower connections.
Uploading Files
There are two ways to upload files:
- Drag and drop — drag files from your computer directly onto the file browser area. A drop zone overlay appears to confirm the target.
- File picker — click the Upload Files button to open the system file picker. Multiple files can be selected at once.
Upload progress is shown for each file individually. Files are available immediately after upload — no confirmation step is required.
Uploaded files are publicly accessible via the URL copied using the Copy URL button. These URLs can be used directly in HTML blocks or image elements in the Portal Designer.
Copying the Public URL
Click the Copy URL button on any file card to copy its full public URL to your clipboard. This URL can be pasted:
- Into an Image element in Portal Designer as the image source
- Into an HTML Block as an
<img src="...">tag - Into an email template body to embed an image
Files uploaded directly inside the Portal Designer editor are automatically saved to Portal Media and will appear here. The two modules share the same storage — you do not need to upload twice.
Deleting Files
Click the Delete button (trash icon) on a file card to permanently remove the file. A confirmation prompt appears before deletion.
Deleting a file that is currently referenced in a published portal template will immediately break its display on the live captive portal — guests will see a broken image. Always check usage before deleting. A warning is shown if the file is referenced in any template, but deletion is still permitted.
Storage Quota
A storage usage bar is shown at the top of the Portal Media page, displaying:
- Used storage — total size of all uploaded files for this tenant
- Total quota — the maximum storage allocated to this tenant (configurable by the system administrator)
- Percentage used — visual progress bar; turns orange at 80% and red at 95%
When the quota is reached, new uploads are blocked until existing files are deleted. Contact your system administrator to increase the storage quota.
Storage quota is per-tenant and applies across all portal media. Enterprise portal media (used in Wifi Enterprise) is stored in a separate path and has its own quota tracking.
Required Permissions
view-portal-media · create-portal-media · delete-portal-media