The Media Tab: Reviewing and Managing Uploaded Files

The Media tab is the second top-level tab inside any job, accessible by clicking the Media button in the two-tab toggle at the top of the task sheet or full-page view. It organizes all uploaded files into four visual sections: Images (photos), Videos, Floor Plans, and Virtual Tours. Each section shows a count of items and renders a thumbnail grid. The Virtual Tours section is read-only — panoramas arrive from the capture app and cannot be manually uploaded through this tab.

Each thumbnail in the grid supports a hover state that reveals action buttons: a fullscreen expand icon to open the media lightbox, and (in edit mode) a selection checkbox. The lightbox is a modal overlay that shows the full-size image or plays the video, with previous/next arrow navigation across all items in the same category. For 3D content and documents, the lightbox renders an iframe embed with an 'Open in new tab' fallback. The filename is shown at the bottom and can be renamed by double-clicking it in edit mode.

Edit mode is activated by clicking the Edit button in the top-right corner of the Media tab. In edit mode the toolbar changes to show a Done button, a Select All / Deselect All toggle, and — once you have selected one or more items — bulk action buttons: Showcase, Unshowcase, and Delete. Showcase marks files as featured assets that surface in delivery galleries with higher visual prominence. Drag-and-drop reordering is available in edit mode: grab the grip handle on any row and drag it to a new position; the order is saved to the backend immediately. A hint at the bottom of the edit toolbar reads 'Tap items to select. Drag items to reorder. Double-tap a filename to rename.'

Provider accounts (technicians uploading from a personal workspace) have upload limits enforced client-side: up to 50 images at 200 MB max, 1 video per upload batch with no size cap, up to 10 floor plans at 200 MB max, and up to 5 documents at 200 MB max. Company account users (admins, editors, project managers working inside an organization) have no enforced limits. These limits exist because provider uploads are typically raw-shoot deliveries, while company-side uploads are post-edited final assets.

On iOS, the Deliverables tab of OrderDetailView shows the same media organized under a Media section built from the MediaItemDTO array returned by GET /projects/:id/media. Each item row shows a thumbnail, filename, media type icon, and upload date. Tapping an item opens the system share sheet or the in-app viewer (WKWebView for virtual tours, PDFKit sheet for brochure PDFs). The property artefacts card above the media list surfaces the property website URL and brochure PDF as tappable rows opening in the in-app viewer.