MediaHub 1.17: Focus Point, opt-in SVG uploads, and KONKAT compatibility
The v1.17 release brings Focus Point cropping for smarter auto-generated crops, opt-in SVG upload support with required sanitisation, and improved compatibility with the ProcessWire KONKAT light admin theme.
Peter Knight
20 May 2026
This post was written with AI assistance. The ideas, opinions, and technical decisions are mine. The tone of voice, content structure, and final copy are a mix of my prompts and AI-assisted drafting.
MediaHub 1.17 is the release I flagged at the end of 1.16: Focus Point is here. Set the important part of an image once, and MediaHub uses it when framing auto-generated crops and when you open the crop editor. Also in this release: opt-in SVG upload support and improved compatibility with the ProcessWire KONKAT light admin theme.
Nothing in 1.17 is breaking. If you're upgrading from 1.16.x you can drop it in without touching template code, though you may want to read the Focus Point section below if your sites rely heavily on auto-generated crops.
Focus Point
Focus Point and focus-aware cropping are already part of ProcessWire. Native image input fields have supported them for years: set a marker on the image, and resized variations frame around it. MediaHub was always going to inherit that behaviour, but it landed later than I wanted while I worked through other high-priority improvements elsewhere in the module.
I'm glad it's here now. Focus Point is a feature I rely on in stock ProcessWire image fields, and I'm happy to bring the same workflow into MediaHub's custom input fields.
If you've ever watched MediaHub generate a landscape crop from a portrait photo and wondered why the subject's face ended up half out of frame, you've hit the limitation of centre-weighted cropping when no focus point is set. The geometric centre of an image is rarely where the subject actually is. Drag a marker to the part of the image that matters, save it, and MediaHub frames auto-generated crops around that point instead. The marker defaults to the centre until you move it, so existing behaviour is unchanged until you opt in per image.
You can set Focus Point from three places:
- Asset detail page: click Focus point in the Actions panel.
- MediaHub field card (Detail mode): click Focus in the Crop · Focus · Edit strip below the filename.
- Inside the crop editor: toggle Focus in the toolbar while you work on a crop.
When you move the marker away from centre, inline crop badges on field cards, lazy-generated crops in templates, and the initial selection when you pick a preset in the crop editor all respect the new position. Existing manually positioned crops are not overwritten automatically. To apply a new Focus Point to a crop you already saved, open that crop and save again.
One thing worth stating plainly: Focus Point is stored on the source image, not per page reference. MediaHub assets are centralised, so changing Focus Point on a library image changes framing everywhere that image is used. That's intentional. If you need different framing on different pages, use manual crop positioning instead.
Each MediaHub field also has a Focus point selection setting under its Input configuration (Enabled / Disabled). It's on by default. Switch it off for fields that hold icons, logos, or other graphics where a focal marker would just get in the way.
Crop and Focus editing now share the same editor surface, so you're not switching between different modals depending on which button you clicked. That's a quality-of-life improvement rather than the headline; the headline is smarter framing without re-cropping every preset by hand.
SVG uploads (opt-in)
A request from a user who uses SVGs a lot in their projects. SVGs are useful for logos, icons, and illustrations that need to scale cleanly. They're also a different class of file from raster images, so 1.17 treats them carefully.
SVG uploads are off by default. A new SVG Support section in Modules → Configure → MediaHub holds an Allow SVG uploads checkbox and a sanitiser status indicator. Existing sites see no change after upgrade until you explicitly enable it.
When the option is on, uploads require the native ProcessWire module FileValidatorSvgSanitizer. If the sanitiser isn't installed, uploads are refused with a clear message rather than letting an unsanitised file through.
Crop and Focus Point are not available for SVG assets. Vector files scale to any size without a framing decision at output time, so the Crop and Focus buttons are hidden on SVG cards and on the SVG asset detail page. Inline crop badges are not rendered for SVGs either. Raster images (JPG, PNG, GIF, WebP) behave as before.
Detail mode and asset detail polish
A handful of UI improvements support the Focus Point workflow without needing their own release notes.
Detail-mode field cards now show a Crop · Focus · Edit action strip directly below the filename, with dimensions, size, and format inline to the right. The edit drawer opened from the pencil icon includes Focus Point alongside Crop. Newly added cards show the correct thumbnail and aspect ratio immediately, without requiring a page save first.
On the asset detail page, the main panel is now a bordered card with the page background showing around it. The Crops table adds a Modified column next to Created, and crop thumbnails display at their natural aspect ratio. Deleting an asset or crop now warns you if the item is referenced elsewhere on the site, with a link to view usage.
KONKAT compatibility
If you run the ProcessWire KONKAT light admin theme, 1.17 includes improved compatibility across MediaHub's admin screens. KONKAT's styling differs enough from Uikit, Reno, and Default that occasional layout clashes are inevitable in a module this UI-heavy; this pass tidies the ones that showed up during Focus Point and crop editor testing.
Download
MediaHub 1.17 is available from the downloads page. The full list of changes is in the changelog, and the Focus Point workflow is documented on the Focus Point docs page.