Asset Detail Page

Overview

Each asset in the library has its own detail page. Click any asset tile in the library to open it.

The main content sits in a bordered card; the page background shows through around it. The header strip shows stat cubes for file format, size, dimensions (images), crop count, and usage count. Below that:

• Preview - full image preview for images; native audio/video player for uploaded media when the browser can decode the file; embedded YouTube/Vimeo player with click-to-play consent for embed assets; preview cover image for PDFs and other non-image types when set; file icon fallback when no cover exists
• Preview image (non-image assets) - choose a library image or crop as the tile thumbnail, or rely on auto-generated covers when the server supports them. See Preview Covers
• File information - filename, format, MIME type, file size, dimensions, upload date, and page ID
• Crops - all crops created for this asset, viewable in grid or list mode. List view includes Created and Modified columns.
• Image variations (raster images, from 1.21) - the original file plus every ProcessWire size variation already on disk in this asset's files folder, with dimensions, file size, modified time, and download. You can delete a variation after confirming. ProcessWire recreates a deleted size the next time a template, a field card, or pre-generated sizes on save requests it. The table lists existing files only; it does not generate new sizes. See Field automation for pre-generating sizes on upload and save.
• Usage - every ProcessWire page that references this asset, with links to edit or view
• Metadata sidebar - from 1.19.25, split into Asset details (title, filename, alt text for images, custom fields) and Asset Internal Notes (About, labels, collections, preview image for non-image assets). A heart control marks or clears the asset as a site-wide favourite.

Actions

The Actions panel in the sidebar provides:

• Crop image - opens the unified crop editor (raster images only). The action bar offers Save as crop (a child crop linked to this asset, listed in the Crops section above) and Save as new asset (a standalone Library asset with its own metadata). See Image Cropping.
• Focus point - opens the editor to set which part of the image auto-generated crops should frame around (raster images only). See Focus Point.
• Download original - downloads the source file
• Copy URL - copies the direct file URL to the clipboard
• Duplicate asset - creates a copy of the asset as a new page (including the file)
• Delete asset - permanently deletes the asset and all its crops. The confirmation warns you if the asset is referenced on other pages (with a link to view usage) and lists how many crops will be removed.

Renaming files

The master filename in the File Information card has an inline edit button. Clicking it lets you rename the file on disk.

From MediaHub 1.19.0, crop filenames in the Crops section can be renamed the same way (blur or Enter). The crops table and any rich-text embed URLs stay in sync.

Page reference fields remain linked automatically because they reference the page ID, not the filename. Any MediaHub images embedded in rich text (TinyMCE) fields are also updated automatically via the data-mediahub-id rename tracking system. See Rich Text Integration for details.

Usage tracking

The Usage section lists every page that references this asset via a ProcessWire page reference field. Each row shows the page title, URL, field name, and template, with links to open the page in the admin editor or visit the live page.