The Admin Interface

Getting there

Once MediaHub is installed, you'll find it at Setup → Media Hub in the ProcessWire admin navigation. The section has its own sub-navigation: Library, Upload, Labels, Folders, and Import.

The library

The main library view shows all assets. Use the toolbar controls to narrow things down:

• Search — matches asset titles, filenames, alt/description text, and label or collection names
• Type — button menu to restrict to Images, Documents, Audio, or Video
• Collections — searchable button menu with breadcrumb paths; click an active item again to clear
• Labels — button menu; click an active item again to clear
• Crops — show only assets that have crops, or only those without
• Sort — icon button with menu: Newest first, Oldest first, or Name A–Z
• View toggle — switch between Grid (thumbnails), Masonry (proportional thumbnails), and Table (detailed rows with title, filename, ID, type, size, upload date, collections, crops, and labels)

Your chosen view, Details toggle state, and Collections sidebar state are all saved to localStorage and restored on every page load. The preference is applied before the page paints, so there is no flash of the default state before the saved one takes over.

Click any asset tile to open its detail page.

Table view

In Table view, clicking anywhere in a row selects it and toggles the checkbox. You don't need to aim for the checkbox precisely. The Title column is excluded from this — clicking a title still navigates to the asset detail page as expected.

Library sidebar

The sidebar on the left combines quick filters, your collection hierarchy, and labels. On desktop it sticks to the top of the viewport while you scroll through the library.

Quick filters at the top:

• All Assets — the full library
• All Collections — assets belonging to at least one collection (live count beside the name)
• Favourites — site-wide starred assets (live count beside the name)
• Recently Added — optional time ranges (e.g. last 7 days) via a context menu on the row

When Favourites or Recently Added is active, a filter pill appears below the toolbar with a one-click × to clear. The context bar shows a breadcrumb trail for the active view, for example All Assets › Favourites (12) × or All Assets › Labels: Dublin (4) ×.

Collections lists your folder hierarchy for filtering. Labels lists global library labels with per-label asset counts. Selecting a collection clears any active label filter and vice versa.

Both Collections and Labels sections can be collapsed; state is saved in localStorage. Use the + buttons in section headers to create a new collection or label in a modal dialog (collections can be nested under an existing parent).

Drag one or more selected asset tiles onto a collection row, a label row, or Favourites to assign or star them in bulk.

Assigning assets to collections from the library

There are two ways to assign assets to collections directly from the library, without opening the asset detail page.

The first is drag and drop. Select one or more asset tiles and drag them onto a collection row in the sidebar. The assets are assigned immediately on drop. A count badge on the drag ghost shows how many assets you're moving, and valid drop targets highlight as you drag over them.

The second is the Collections submenu in the per-asset context menu. See below.

Bulk operations

Tick the checkbox on one or more asset tiles and the breadcrumb row swaps for bulk action icons in the same context bar: Collections, Labels, and Delete, with a selected count and clear control. The Details toggle stays on the right; search and filter controls in the toolbar above stay available.

The practical change is workflow order. Previously, bulk assignment often meant creating a collection or label first (sidebar or Folders), then dragging assets onto it or picking a target from a dropdown. Now you select the assets first, then open one picker to assign, unassign, search, or create new collections and labels on the spot.

• Collections — unified picker with checkboxes, search, and inline create-new. One panel replaces the old separate add and remove buttons.
• Labels — same checkbox picker pattern.
• Delete — permanently delete all selected assets. Single-asset delete uses the same usage-aware confirmation as the asset detail page; multi-select reports total crop variants across the selection.

Press Escape or click the clear control to deselect all.

Per-asset context menu

Each tile has a ⋯ menu with quick actions: View details, Download original, Copy URL, Duplicate, mark or unmark Favourite, and Collections.

The Collections entry opens a flyout panel listing every collection with a checkbox. The asset's current memberships are pre-checked. Toggling a checkbox adds or removes the asset immediately via AJAX, with no page reload. A Done button closes the flyout; clicking outside or pressing Escape also works. This is the easiest way to assign an asset to multiple collections at once, or to remove a membership.

Other admin improvements

Optional Media Hub entry in the admin top bar (Modules → MediaHub → Show MediaHub link in main navigation), drag-to-reorder thumbnails in MediaHub fields, and a master select all visible checkbox in Library list view. See the changelog for details.