Media Library
The Media Library is the central store for every image and video you put on a screen. Anything you want to play in a layout, playlist, or menu board has to live here first.
How to get there: Sidebar → Media Library, or /media.
Page layout
Section titled “Page layout”Folder tree on the left, content on the right. The right side has its own scroll, so a long library doesn’t push the rest of the page around.
The page header carries four icon actions:
| Icon | What it does |
|---|---|
| Archive (toggles “View Purge List”) | Switches the table to show retired items only. |
| Eraser (“Library Tidy”) | Removes unused media files (admin / delete permission). Asks twice. |
| Link (“Upload from URL”) | Imports a file from a URL the server can reach. |
| Upload (filled, primary) | Opens the upload dialog. |
Below the header are a media-type selector (All Media / Images / Videos) and a grid / list toggle. Both selections persist in the URL — if you bookmark a filtered view, the filters come back when you return.
Supported formats
Section titled “Supported formats”Drag-and-drop accepts image/* and video/*. The drop hint lists the most common formats:
JPEG, PNG, GIF, WebP, SVG, MP4, WebM, MOV
Other formats (audio, fonts, HTML packages) can also be in the library, but they’re typically managed elsewhere — fonts on the Fonts page, for example.
Grid view (default)
Section titled “Grid view (default)”Rendered as a virtualised grid: 2 columns on small screens, scaling up to 5 on wide screens. Only the visible rows render, so a library with thousands of items still scrolls smoothly. Scrolling near the bottom triggers the next page (100 items at a time).
Each card shows a thumbnail, the file name, type icon, and quick actions on hover. Click the card to open the preview dialog — image preview or video player.
List view
Section titled “List view”A standard data table with these columns:
| Column | Notes |
|---|---|
| Preview | Small thumbnail (md+ screens). Falls back to a video icon when no thumbnail exists. |
| Name | Clickable — opens the media detail page at /media/[id]. |
| Size | Human-readable file size (md+). |
| Dimensions | width×height for images and videos that report it (lg+). |
| Modified | Relative time (lg+). |
| Expires | Relative time. Red when in the past, amber when within 7 days (xl+). |
The toolbar provides search by name. Bulk selection checkboxes appear on every row.
Uploading
Section titled “Uploading”From your computer
Section titled “From your computer”Click the Upload button (or just drag files onto the drop zone visible at md+ screen sizes). The upload dialog opens with two tabs:
- Options — name, target folder, tags, and optional playlist attachment.
- Advanced — replace an existing media item, propagate the replacement into layouts, delete old revisions, and set playlist widget date constraints when attaching to a playlist.
While uploads are in progress, an upload progress overlay appears in the corner with per-file progress bars. You can cancel an upload from there. Completed and failed uploads stay visible until you clear them.
From a URL
Section titled “From a URL”Click the Link icon (Upload from URL). Paste the URL, optionally set a name, target folder, and expiry. The server downloads the file directly; your browser never touches it. Useful for pulling in assets from a partner CDN.
Setting an expiry
Section titled “Setting an expiry”URL uploads can set an expiry date during import. Computer uploads can set playlist widget date constraints when adding the upload directly to a playlist; media expiry can also be changed later from Edit. Expired items are flagged red in the library, and items expiring within 7 days highlight in amber as a heads-up. Delete on expiry is available when editing media.
Filtering by folder
Section titled “Filtering by folder”Click any folder in the tree to filter the right pane. A bar appears under the page title showing the active folder and a Clear filter link. Right-click a folder for Manage Permissions, Create Folder, Delete Folder, or Add All to Playlist.
The last lets you grab every media item under that folder and add it to an existing playlist (or create a new one) in two clicks — handy for promotional bundles dropped into a folder by another team.
Row actions
Section titled “Row actions”Right-click a row (list view) or a card (grid view) to get the context menu. With Purge List off:
| Action | What it does |
|---|---|
| Preview | Opens the preview dialog. |
| Download | Direct download of the original file. |
| Edit | Rename, change duration, retire, set tags / expiry / “delete on expiry”. |
| Move to Folder | Pick a destination folder. |
| Duplicate | Server-side copy with a new name. |
| Add to Purge List | Retire (see below). |
| Delete | Two-step delete. |
With Purge List on, the menu changes to Restore and Delete Permanently.
Purge List (retired items)
Section titled “Purge List (retired items)”When you no longer need a file but aren’t ready to lose it, Add to Purge List retires it. Retired items:
- are hidden from the normal library view,
- are removed from active use in layouts and playlists,
- can be restored at any time,
- can be permanently deleted from the Purge List view.
To work with retired items, click the Archive icon in the page header to enable Purge List view. The button highlights amber while active.
Library Tidy is the bulk version: it removes media that no display needs and that no schedule references. Use it sparingly — it’s irreversible.
Bulk actions
Section titled “Bulk actions”Select rows with the checkboxes. The toolbar swaps in two bulk actions:
- Tag N items — open a tag picker and apply tags to every selected item.
- Delete N — two-step bulk delete.
In Purge List view, the actions become Restore N and Delete Permanently.
Tags are free-text labels (e.g. summer-promo, cafe-menu, lobby). Apply them when uploading, when editing a single item, or via the bulk Tag action. Manage and consolidate the tag list from the Tags page.
Using media in content
Section titled “Using media in content”Once uploaded, media is available in:
- The Layout Designer — drop a media item into a region.
- Playlists — add media as items in a playback sequence.
- Menu Boards — as backgrounds or product images.
Permissions
Section titled “Permissions”- The page appears only when your role includes media access.
- Upload, Edit, Move, and Duplicate require media write or create permission.
- Delete, Library Tidy, and Permanently Delete require media delete permission.
- Folder operations honor folder-level permissions in the tree.