✦ Free & Open Source Kirby 5 Ready

Kirby Media Hub

A WordPress-style centralized media library for Kirby CMS 5. Manage all your assets in one place — folders, drag-and-drop upload, full-text search, metadata editing, and a custom picker field.

Download Free View Pro Plans

📁 Centralized Media Library

Features

Everything your media workflow needs

Built directly into the Kirby Panel — no external services, no subscriptions, no compromise.

Free · V1

Dedicated Media Library

Full-screen Media Hub in the Kirby sidebar. All your assets in one place — no more digging through page files.

Free · V1

Full-text Search & Type Filter

Search filename, title, alt, description, copyright, and photographer simultaneously. Filter by image, document, video, or audio.

Free · V1

Dashboard Statistics

Live counters for total files, unused files, file-type breakdown, recent uploads, and largest files. Updates instantly after every action.

Free · V1

File Metadata & Usage Tracking

Edit title, alt text, description, copyright, and photographer per file. See exactly which pages reference each asset.

Free · V1

mediahubpicker Field

Custom field for any blueprint. Inline expandable picker with multi-select. Saves standard file://uuid references — compatible with Kirby's native files field.

Free · V1

Folder Organisation

Create and delete folders to keep assets tidy. Drag-and-drop upload directly to any folder with instant feedback.

Pro Smart · V2

2-Level Subfolder Support

Nested folders in the sidebar with inline expand/collapse, breadcrumb navigation, and correct upload URLs at every subfolder level.

Pro Smart · V2

Tags & Smart Filtering

Tag files with keywords. Tag cloud in the sidebar. Filter by upload date, uploaded-by user, and file size range — all combinable.

Pro Smart · V2

Bulk Operations

Select multiple files → bulk delete, bulk move, bulk rename with a {n} pattern, or bulk tag assignment (add / remove / replace).

Pro Smart · V2

Duplicate Detection

Scan for exact duplicates (MD5 hash) and similar-named files. Keep oldest, newest, or shortest name — one click per group.

Pro Smart · V2

Auto WebP Conversion & Compression

JPEG and PNG uploads are converted to WebP on the server using PHP GD. UUID is preserved so all existing references continue to resolve. Re-optimize any image on demand.

Pro Smart · V2

Upload Progress Indicator

Animated progress bar and spinner in the drop zone while upload and server-side optimization run. Shows upload and optimizing status in real time.

Quick Start

Up and running in 3 steps

Install

Run composer require kirbycode/media-hub or drop the folder into site/plugins/.

Add to Blueprint

Add type: mediahubpicker to any field in any page blueprint.

Browse & Pick

Open Media Hub in the Panel, upload files, then pick them from any page that uses your picker field.

Pricing

Free to use. Pay only for Pro.

Pro V1 is free and open source. Upgrade to Pro Smart V2 for agencies and power users. One-time payment. Single-site license.

Pro V1

Free

Open source · MIT License

The complete plugin at no cost. Use commercially, forever.

✓ Dedicated Panel area

✓ Folder organisation

✓ Drag & drop upload

✓ Full-text search

✓ Metadata editing

✓ mediahubpicker field

✓ UUID references

✓ Usage tracking

✓ Dashboard stats

— Subfolders

— Tags & Filtering

— Bulk Operations

— Duplicate Detection

— Image Optimization

Download Free on GitHub

Get started quickly

Three steps from zero to a working media library in your Kirby site.

Install

terminal bash

1

2

3

4

5

# Via Composer (recommended)
composer require kirbycode/media-hub

# Or drop the folder manually
cp media-hub/  site/plugins/media-hub/

The plugin auto-creates content/media-hub/ on first load. No extra config needed.

Add to a Blueprint

site/blueprints/pages/project.yml yaml

# Add the picker field to any page blueprint
fields:
  hero_image:
    label: Hero Image
    type:  mediahubpicker
    multiple: false
    accept:  image   # image | document | video | audio

  gallery:
    label: Gallery Images
    type:  mediahubpicker
    multiple: true
    accept:  image

  attachments:
    label: Downloads
    type:  mediahubpicker
    multiple: true
    accept:  document

Read files in your PHP template

templates/project.php — single file php

<?php
// Resolve UUID to a Kirby File object
$hero = $kirby->file(
    $page->hero_image()->value()
);
if ($hero): ?>

  <img
    src="<?= $hero->url() ?>"
    alt="<?= $hero->alt() ?>">

<?php endif; ?>

templates/project.php — gallery loop php

<?php
// Loop over multiple picked files
foreach ($page->gallery()->yaml() as $ref) {
    $file = $kirby->file($ref);
    if (!$file) continue;
?>
  <img
    src="<?= $file->url() ?>"
    alt="<?= $file->alt() ?>">
<?php } ?>

Requirements

Kirby CMS 5.0+

PHP 8.2+

Build step None

Config Optional

Free & Open Source

Download Kirby Media Hub

MIT License · Kirby 5 · PHP 8.2+ · No build step · No telemetry

View on GitHub Release Notes

Get In Touch

Purchase or build something custom

Purchase a Pro License

Send an email with which version you'd like (Pro Smart V2 — €90), your site URL, and invoice details. We reply within 24 hours.

One-time payment
Single-site license
Invoice provided
12 months of updates

Send Purchase Request

Custom Plugin Development

Need extra features, a modified version of Media Hub, or an entirely custom Kirby plugin? Get in touch with what you need.

Custom feature development
Plugin modifications
Integration with existing setups
Fixed-price quotes

Contact for Custom Work

FAQ

Common questions

Can't find your answer? Write to us directly.

info@kirbycode.com

What's the difference between the free and Pro versions?

The free version (Pro V1) is fully functional and open-source — folders, search, metadata editing, the mediahubpicker field, usage tracking, and dashboard stats. Pro Smart V2 adds 2-level subfolders, tags & keywords, smart filtering, bulk operations, duplicate detection, and automatic image optimization with WebP conversion on upload.

Does it work with Kirby 4?

No. Kirby Media Hub requires Kirby 5 and uses Kirby 5 APIs exclusively. It will not work on Kirby 3 or Kirby 4.

What support is included?

The free version is community-supported via GitHub Issues. Pro Smart V2 includes priority email support with a 24-hour response target on business days.

How do I receive updates?

Free version: run composer update kirbycode/media-hub anytime. Pro version: download instructions are sent by email after purchase.