PHPackages                             presprog/kirby-auto-file-templates - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. presprog/kirby-auto-file-templates

ActiveKirby-plugin[Utility & Helpers](/categories/utility)

presprog/kirby-auto-file-templates
==================================

Automatically assign file templates on upload based on the file type

1.0.3(8mo ago)9616↓33.3%1[1 issues](https://github.com/presprog/kirby-auto-file-templates/issues)1MITPHPPHP ^8.2CI failing

Since Mar 19Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/presprog/kirby-auto-file-templates)[ Packagist](https://packagist.org/packages/presprog/kirby-auto-file-templates)[ RSS](/packages/presprog-kirby-auto-file-templates/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (1)Versions (4)Used By (1)

[![Kirby Auto File Templates Plugin](/.github/banner.png)](/.github/banner.png)

Automatically assign templates to your uploaded files
=====================================================

[](#automatically-assign-templates-to-your-uploaded-files)

> ⚡ Ready for Kirby 5!

This plugin automatically assigns file templates to your uploaded files, based on the respective file type. This way it does not matter, which file type you upload from which field or section – the template assigned will always be the same. This is especially handy, when you use a single files section per page, that stores all the different file types used on the page.

Important

Requires at least Kirby 4.0 and PHP 8.2

🚀 How to use
------------

[](#-how-to-use)

Set up your configuration (see next section) first. The plugin will then run after each uploaded file (`file.create:after` hook) and assign the configured template automatically.

If you add the plugin to an existing project, you can run the `auto-templates` command from the CLI. It will iterate over every file in every page and assign the template according to the configuration:

```
$ php vendor/bin/kirby auto-templates

image.png: image
video.mp4: video

> All files updated
```

By default, existing template assignments will not be touched. To change that, run the command with `--force/-f` or set the `forceOverwrite` option globally in your `config.php` (see below).

⚙️ Config
---------

[](#️-config)

The plugin works in an opt-in manner: It does nothing except you tell it to.

```
// site/config/config.php

'presprog.auto-file-templates' => [
  // Do nothing (default)
  'autoAssign' => false,

  // OR automatically assign a file template for every file type
  'autoAssign' => true,

  // OR only assign templates to some file types (ignore file types other than `image` and `video`
  'autoAssign' => [
      'image' => true,
      'video' => true,
  ],

  // OR define a specific template for just some file types and let the plugin decide for the others
  'autoAssign' => [
      'image' => 'my-custom-image-blueprint',
      'video' => true, // => 'video'
  ],

  // OR handle more advanced use-cases in callable yourself (assign different file templates for vector and raster images)
  'autoAssign' => [
      'image' => function(\Kirby\Cms\File $file) {
          return match (F::extension($file->filename())) {
              'svg'   => 'vector',
              default => 'image',
          };
      },
  ],

  // Overwrite existing template assignments (default: false)
  'forceOverwrite' => true,
],
```

With `autoAssign = true`, each file type will get the identically named file blueprint assigned as template:

File typeFile blueprintaudiosite/blueprints/files/audioarchivesite/blueprints/files/archivecodesite/blueprints/files/codeimagesite/blueprints/files/imagevideosite/blueprints/files/videoyour-typesite/blueprints/files/your-type\* The Kirby core file types `archive`, `audio`, `document`, `image` and `video` and [your custom file type extensions](https://getkirby.com/docs/reference/plugins/extensions/file-types) are supported out-of-the-box.

💻 How to install
----------------

[](#-how-to-install)

Install this plugin via **Composer** (recommended):

```
composer require presprog/kirby-auto-file-templates
```

Or **download the ZIP file** from GitHub and unpack it to `site/plugins/kirby-auto-file-templates`

Or as **Git submodule**

```
git submodule add https://github.com/presprog/kirby-auto-file-templates.git site/plugins/auto-file-templates
```

✅ To do
-------

[](#-to-do)

- Add multi-language support

📄 License
---------

[](#-license)

MIT License Copyright © 2025 Present Progressive

---

[![](/logo.svg?raw=true)](/logo.svg?raw=true)

Made by [Present Progressive](https://www.presentprogressive.de) for the Kirby community.

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance58

Moderate activity, may be stable

Popularity24

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 98.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~290 days

Total

3

Last Release

255d ago

Major Versions

0.1.0 → 1.0.12024-04-26

### Community

Maintainers

![](https://www.gravatar.com/avatar/fb1ebdab7f2ba8b43be86588cbdcf153b0342e9364c3c890f8b8d6715fccbc3f?d=identicon)[presprog](/maintainers/presprog)

---

Top Contributors

[![bezin](https://avatars.githubusercontent.com/u/4400435?v=4)](https://github.com/bezin "bezin (68 commits)")[![caplod](https://avatars.githubusercontent.com/u/435070?v=4)](https://github.com/caplod "caplod (1 commits)")

---

Tags

kirbykirby-4kirby-5kirby-cmskirby-plugin

### Embed Badge

![Health badge](/badges/presprog-kirby-auto-file-templates/health.svg)

```
[![Health](https://phpackages.com/badges/presprog-kirby-auto-file-templates/health.svg)](https://phpackages.com/packages/presprog-kirby-auto-file-templates)
```

###  Alternatives

[getkirby/cms

The Kirby core

1.5k584.8k472](/packages/getkirby-cms)[medienbaecker/kirby-modules

Easily add modules to your pages

895.5k1](/packages/medienbaecker-kirby-modules)[distantnative/retour-for-kirby

Manage redirects and track 404s right from the Kirby CMS Panel

14698.5k1](/packages/distantnative-retour-for-kirby)[arnoson/kirby-vite

Vite helper for Kirby CMS

9765.1k3](/packages/arnoson-kirby-vite)[bnomei/kirby3-dotenv

Kirby Plugin for environment variables from .env

4149.6k2](/packages/bnomei-kirby3-dotenv)[medienbaecker/kirby-alter

242.1k](/packages/medienbaecker-kirby-alter)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)