PHPackages                             diesdasdigital/kirby-meta-knight - 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. diesdasdigital/kirby-meta-knight

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

diesdasdigital/kirby-meta-knight
================================

Meta Knight – SEO for Kirby

1.2.2(4y ago)11025.9k↓55.6%17[21 issues](https://github.com/diesdasdigital/kirby-meta-knight/issues)[13 PRs](https://github.com/diesdasdigital/kirby-meta-knight/pulls)BSD-3-ClauseVue

Since Nov 26Pushed 3y ago7 watchersCompare

[ Source](https://github.com/diesdasdigital/kirby-meta-knight)[ Packagist](https://packagist.org/packages/diesdasdigital/kirby-meta-knight)[ RSS](/packages/diesdasdigital-kirby-meta-knight/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (17)Used By (0)

Meta Knight – SEO for Kirby
===========================

[](#meta-knight--seo-for-kirby)

Meta Knight is a SEO and Social Media Sharing Plugin for [Kirby](https://getkirby.com). Meta Knight makes it easier to work with meta information in Kirby's panel.

Meta Knight provides blueprints, snippets and custom preview sections. At the moment the plugin covers:

- Basic Meta Information (Title, Description, Keywords, Canonical URL, etc.) + Google Search Preview
- Open Graph + Facebook Sharing Preview
- Twitter Cards + Twitter Cards Preview
- Robots Settings

All of the above is neatly organized in a pre-composed SEO tab that can easily be added to any blueprint.

[![Screenshot](screenshot.gif)](screenshot.gif)

This plugin was originally developed at [diesdas.digital](https://www.diesdas.digital) by Jonathan Muth, Lorenz Seeger and Leslie Büttel. Meta Knight exists because we wanted to standardize the way we handle meta information across all our projects.

We'd also like to thank @distantnative for his help along the way! Without him this plugin wouldn't be what it is today.

Config options
--------------

[](#config-options)

### Site title

[](#site-title)

#### Order

[](#order)

By default the *Page Title* will be rendered before the *Site Title*. Resulting in a title tag that looks like this: `Page Title – Site Title`. If you want the *Site Title* to come first, simply add the following lines to your Kirby `config.php` file:

```
'diesdasdigital.meta-knight' => [
    'siteTitleAfterPageTitle' => false,
],

```

You'll then get a title tag that looks like this: `Site Title – Page Title`.

#### Customize home page title

[](#customize-home-page-title)

By default the title tag of the home page will include both the *page title* and the *site title* and look like this: `Page Title – Site Title`. If you want to only display the site title on the homepage, simply add the following lines to your Kirby `config.php` file:

```
'diesdasdigital.meta-knight' => [
    'siteTitleAsHomePageTitle' => true,
],

```

The title tage of your home page will then look like this: `Site Title`

The same can be done with the page title on the homepage

```
'diesdasdigital.meta-knight' => [
    'pageTitleAsHomePageTitle' => true,
],

```

will result in `Page Title`

Keep in mind: Both options cannot be enabled at the same time.

### Customizeable `page title | site title` separator

[](#customizeable-page-title--site-title-separator)

The separator between page title and site title can be customized like this:

```
'diesdasdigital.meta-knight' => [
    'separator' => ' \o/ ',
],

```

The default value is `|`.

### Canonical URLs

[](#canonical-urls)

Meta Knight gives you control over how the auto-generated canonical URLs for your pages are rendered. By default canonical URLs do not include the `www.` subdomain. If you wish the canonical URLs to include `www.` please set the following option in config.php:

```
'diesdasdigital.meta-knight' => [
    'canonicalURLIncludesWWW' => true,
],

```

Please note:

- Auto-generated canonical URLs will always be the `https://` version of any given page.
- Do not enable `canonicalURLIncludesWWW` if your Kirby site is running on another subdomain.
- A canonical URL that was manually entered in the SEO Tab will always override the auto-generated canonical URL of any given page.

---

Installation
------------

[](#installation)

### Download

[](#download)

Download and copy this repository to `/site/plugins/kirby-meta-knight`.

### Git submodule

[](#git-submodule)

```
git submodule add https://github.com/diesdasdigital/kirby-meta-knight.git site/plugins/kirby-meta-knight
```

### Composer

[](#composer)

```
composer require diesdasdigital/kirby-meta-knight
```

Setup
-----

[](#setup)

How to add Meta Knight to Kirby:

1. Add this tab to your site's blueprint (site.yml): `seotab: seo` (Meta Knight uses the site's meta information as a fall back when no meta information is provided for a page)
2. Add this tab to all your page blueprints: `seotab: seo`
3. Add these two snippets to your head: `` + ``

Example:

```
title: Site

tabs:
  content:
    icon: text
    label: Content
    sections:
      drafts:
        headline: Drafts
        type: pages
        status: draft
        templates:
          - default
          - masthead
        image:
          query: false
      unlisted:
        headline: Unlisted
        type: pages
        status: unlisted
        image:
          query: false
      listed:
        headline: Listed
        type: pages
        status: listed
        image:
          query: false

  seotab: seo
```

Options
-------

[](#options)

Currently the plugin isn't configurable via the `config.php` file. This is something we are thinking about adding in a future release.

Development
-----------

[](#development)

### Development

[](#development-1)

You can start the dev process with …

```
yarn dev
```

This will automatically update the `index.js` and `index.css` of Meta Knight as soon as you make changes. It will also enable hot module reloading in the panel. Reload the panel once and afterwards you should see changes immediately without further reloading.

### Production

[](#production)

As soon as you are happy with the changed you've made to Meta Knight, you should build the final version with

```
yarn build
```

This will automatically create a minified and optimized version of your `index.js` and `index.css` that will improve load time in production environments.

License
-------

[](#license)

MIT – See LICENSE.md for more info.

Credits
-------

[](#credits)

- [diesdas ⚡️ digital](https://github.com/diesdasdigital)

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance16

Infrequent updates — may be unmaintained

Popularity42

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 81% 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 ~39 days

Recently: every ~66 days

Total

10

Last Release

1644d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16120382?v=4)[Diesdas Digital](/maintainers/diesdasdigital)[@diesdasdigital](https://github.com/diesdasdigital)

---

Top Contributors

[![jonathanmuth](https://avatars.githubusercontent.com/u/1757108?v=4)](https://github.com/jonathanmuth "jonathanmuth (85 commits)")[![lesabu](https://avatars.githubusercontent.com/u/29930343?v=4)](https://github.com/lesabu "lesabu (8 commits)")[![S1SYPHOS](https://avatars.githubusercontent.com/u/12161504?v=4)](https://github.com/S1SYPHOS "S1SYPHOS (3 commits)")[![grommas](https://avatars.githubusercontent.com/u/5681075?v=4)](https://github.com/grommas "grommas (2 commits)")[![maxhoffmann](https://avatars.githubusercontent.com/u/1227441?v=4)](https://github.com/maxhoffmann "maxhoffmann (1 commits)")[![rootman](https://avatars.githubusercontent.com/u/153284?v=4)](https://github.com/rootman "rootman (1 commits)")[![aascensao](https://avatars.githubusercontent.com/u/677662?v=4)](https://github.com/aascensao "aascensao (1 commits)")[![skyeewers](https://avatars.githubusercontent.com/u/13334117?v=4)](https://github.com/skyeewers "skyeewers (1 commits)")[![bogdancondorachi](https://avatars.githubusercontent.com/u/39380741?v=4)](https://github.com/bogdancondorachi "bogdancondorachi (1 commits)")[![iskrisis](https://avatars.githubusercontent.com/u/4954323?v=4)](https://github.com/iskrisis "iskrisis (1 commits)")[![jasminsallam](https://avatars.githubusercontent.com/u/56875105?v=4)](https://github.com/jasminsallam "jasminsallam (1 commits)")

---

Tags

kirby-cmskirby-pluginkirby3

### Embed Badge

![Health badge](/badges/diesdasdigital-kirby-meta-knight/health.svg)

```
[![Health](https://phpackages.com/badges/diesdasdigital-kirby-meta-knight/health.svg)](https://phpackages.com/packages/diesdasdigital-kirby-meta-knight)
```

###  Alternatives

[distantnative/retour-for-kirby

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

14689.4k1](/packages/distantnative-retour-for-kirby)[mzur/kirby-uniform

A versatile Kirby plugin to handle web form actions.

26068.3k13](/packages/mzur-kirby-uniform)[arnoson/kirby-vite

Vite helper for Kirby CMS

9759.2k3](/packages/arnoson-kirby-vite)[thathoff/kirby-git-content

Plugin to track changes to content in a git repository.

15343.7k](/packages/thathoff-kirby-git-content)[sylvainjule/locator

A map & geolocation field, built on top of open-source services / Mapbox

11237.3k1](/packages/sylvainjule-locator)[tobimori/kirby-seo

The default choice for SEO on Kirby: Implement technical SEO & Meta best practices with ease and provide an easy-to-use editor experience

10039.7k1](/packages/tobimori-kirby-seo)

PHPackages © 2026

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