Version 1.x

The first stable release of MediaHub, covering installation, the admin interface, field configuration, the template API, and image cropping.

New to MediaHub? The Quickstart guide gets you from installation to displaying images in templates in a few minutes.

What's covered in v1.x

Version 1 is the initial stable release of MediaHub. It establishes the core concept: a single source of truth for all uploaded assets across a ProcessWire site, with a full admin interface and a clean PHP API for template developers.

Release history

v1.11.0 (3 Apr 2026): Non-image assets become first-class citizens. TinyMCE picker shows all file types with MIME-aware insertion (video, audio, document links). Insert Link dialog gains "Select from Media Hub" for linking text to any library asset. Non-image display improvements throughout the Inputfield and Library. "Images" container page renamed to "Assets" (both name and title). Version format switched to semver strings. See the full changelog.
v1.10.0 (1 Apr 2026): Collections workflow, state persistence, and a better inputfield. Drag-and-drop assets onto collections in the sidebar, assign to multiple collections via a new context menu submenu, sticky Collections sidebar while scrolling, thumbnail size slider and genuine proportional display in the inputfield, library state persistence with zero-flash restore, click-anywhere-to-select in Table view, logging off by default. See the full changelog.
v1.9.0 (30 Mar 2026): Major performance overhaul for the site-wide Scan & Import and library view. Scan is 825x faster, import is 18x faster, library loads instantly after import. Tested with 25,000 images. Also includes improved non-image file type support with dedicated icons and previews for documents, spreadsheets, presentations, audio, and video. See the full changelog.
v1.8.1 (27 Mar 2026): Config page polish: lower default upload batch (50), fix privacy field HTML rendering, lighter placeholder text in custom presets, cleaner Upload Automation layout, refined license key copy.
v1.8.0 (25 Mar 2026): Optional, non-blocking license registration for support and usage analytics. No functionality is gated. Automatic environment migration, local/dev detection, and privacy-first design.
v1.7.0 (25 Mar 2026): Single-step install and uninstall via PW's installs key. Two uninstall modes: full delete or keep assets on disk for migration. Pre-uninstall audit, complete artifact cleanup, Uninstall Preparation panel.
v1.6.1 (23 Mar 2026): Removed stale rename warning from the asset detail drawer; renaming already updates all RTE embeds automatically.
v1.5.0 (23 Mar 2026): Custom crop preset groups (Social, Editorial, etc.), ensureCropImage() for lazy crop generation in templates, admin-side auto-generation of missing preset crops, template restriction for crop badges, key collision handling for presets.
v1.4.0 (18 Mar 2026): Library UX overhaul: masonry view, collapsible details toggle, pagination.
v1.3.0 (18 Mar 2026): Fullscreen picker overlay, grid/masonry/list modes in the picker, upload queue UX improvements.
v1.2.0 (18 Mar 2026): TinyMCE integration for inserting MediaHub images into rich text with rename-safe URL tracking. Live search and collection tooltips in the picker. PHP 8.0 is now the minimum. Unified versioning across the three modules.
v1.1.3 (15 Mar 2026): Configurable upload batch limit (default 50 files) with in-UI warning; prevents browser crashes on large file selections.
v1.1.2 (13 Mar 2026): Removed WebP from default allowed extensions (GD cannot resize WebP sources); configuration UI clarified.
v1.0.10 (18 Mar 2026): Compact list-style upload queue with parallel uploads, per-file progress, and retry on failure.
v1.0.7 (12 Mar 2026): Fixed undefined variable notice on asset detail page after saving a crop.
v1.0.6 (12 Mar 2026): Fixed WebP source detection for GD resize; fresh install now correctly sets up crop infrastructure; delete moved to context menu.
v1.0.5 (12 Mar 2026): Safe thumbnail fallback for servers where GD cannot write WebP; all browser dialogs replaced with styled modals.
v1.0.4 (12 Mar 2026): InputfieldMediaHub registered as an available inputfield for FieldtypePage.
v1.0.3 (10 Feb 2026): Images now stored in a dedicated FieldtypeImage field, enabling the full PW image API. Existing assets migrated automatically on upgrade.
v1.0.2 (10 Feb 2026): Fixed selected assets persisting after page save; auto-corrected field template config.
v1.0.1 (Feb 2026): Picker modal, single and multi-select field support.
v1.0.0 (Feb 2026): Initial release. Core module, admin UI, upload, library, tags.

Upgrading from a pre-release version

If you were using a pre-release build, run Modules → Refresh and then check the MediaHub module page for any pending upgrade notices. The v1.0.3 upgrade migrates image assets from the file field to the image field automatically. No manual steps are required, but back up your site before upgrading as a precaution.

Introduction

Why MediaHub?

A shared media library changes how you think about images. Instead of uploading the same photo five times to five pages, you upload once and reference everywhere. Here's what that means in practice.

Getting Started

What MediaHub is, why you might want it, and what to expect before you install.

Quickstart ⭐

The shortest path from download to working output. Install the module, upload an asset, create a field, and render it in a template.

Installation & Setup

Installation

MediaHub is three modules, not one. Here's why, and exactly how to install them in the right order.

Configuration

All the settings you can adjust in Modules → Configure → MediaHub, and what they actually do.

Uninstalling

MediaHub requires a review, a mode selection, and a typed confirmation before it will uninstall. Here is what happens at each step and how to recover your files if you need them.

Using Media Hub

The Admin Interface

Navigating Setup → Media Hub: the library view, search, filters, bulk operations, and per-asset context menu.

Uploading Assets

How to upload files to MediaHub: drag-and-drop, batch upload, pre-upload preview, validation, and automatic collection assignment.

Asset Detail Page

The asset detail view: preview, file information, crops, usage tracking, metadata editing, renaming, and actions.

Image Cropping

The crop editor, save options, adjusting existing crops, cascade delete, and custom crop presets with groups.

Developer Reference

Adding MediaHub Field(s) to Templates

How to create a MediaHub field, add it to a template, and configure it for your specific use case, including crop badges and per-reference tags.

Template API

How to work with MediaHub assets in your PHP templates. Getting images, resizing, type checking, metadata, tags, collections, crops, and common output patterns.

Crops API

How to check for, retrieve, and output crops in your template code, including lazy generation and the crop-or-fallback pattern.

Per-Reference Metadata

Each selected asset can carry page-level metadata (a description override and display tags) stored separately from the global asset record. The same image can have a different caption depending on where it appears.

Querying Assets

Using ProcessWire selectors to find assets in the library by type, tag, collection, title, or any combination. Plus the Collection page class API for working with folders and hierarchies.

Migration Guide: Moving Sites to MediaHub

A step-by-step approach to transitioning an existing ProcessWire site from native image fields to MediaHub, including running both systems side by side.

Reference

Changelog

What changed in each release of MediaHub v1.x.

Other

Working with Files

Using MediaHub for PDFs, documents, audio, video, and other non-image assets.