PHPackages                             getkirby/layouts - 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. [Templating & Views](/categories/templating)
4. /
5. getkirby/layouts

ActiveKirby-plugin[Templating & Views](/categories/templating)

getkirby/layouts
================

Kirby Layouts

2.0.1(3y ago)428.4k2MITPHPPHP >=8.0.0 <8.3.0

Since Nov 18Pushed 1y ago6 watchersCompare

[ Source](https://github.com/getkirby/layouts)[ Packagist](https://packagist.org/packages/getkirby/layouts)[ Docs](https://getkirby.com)[ RSS](/packages/getkirby-layouts/feed)WikiDiscussions main Synced today

READMEChangelog (4)Dependencies (2)Versions (5)Used By (0)

Kirby Layouts plugin
====================

[](#kirby-layouts-plugin)

This plugin extends Kirby’s new snippets with slots and loads layout snippets from `site/layouts`

**This version of the plugin requires Kirby 3.9.0 and helps to migrate from the old layout plugin to our new snippets. We recommend to use native snippets instead.**

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

[](#installation)

### Download

[](#download)

Download and copy this repository to `/site/plugins/layouts`.

### Git submodule

[](#git-submodule)

```
git submodule add https://github.com/getkirby/layouts.git site/plugins/layouts

```

### Composer

[](#composer)

```
composer require getkirby/layouts

```

How it works
------------

[](#how-it-works)

You can create full HTML layouts in a new `/site/layouts` folder. Layouts can define slots, which will then be filled with content by templates. Layouts are based on our new snippets with slots and work exactly the same way. The only difference is the folder location. You can learn more about our snippets with slots in our docs:

#### /site/layouts/default.php

[](#sitelayoutsdefaultphp)

```

    title() ?>

```

#### /site/templates/my-template.php

[](#sitetemplatesmy-templatephp)

```

Hello world
This will end up in the default slot
```

### Choosing a layout

[](#choosing-a-layout)

To use a specific layout, you can pass its name to the `layout()` method.

#### /site/layouts/blog.php

[](#sitelayoutsblogphp)

```

    Blog

    Blog

```

#### /site/templates/blog.php

[](#sitetemplatesblogphp)

```

```

Working with slots
------------------

[](#working-with-slots)

You can add as many different slots to your layout as you need. The default slot goes without a specific name. Every other slot needs a unique name. Slots in layouts can define default content, which will be rendered if the slot is not used in the template.

Read more:

What’s Kirby?
-------------

[](#whats-kirby)

- **[getkirby.com](https://getkirby.com)** – Get to know the CMS.
- **[Try it](https://getkirby.com/try)** – Take a test ride with our online demo. Or download one of our kits to get started.
- **[Documentation](https://getkirby.com/docs/guide)** – Read the official guide, reference and cookbook recipes.
- **[Issues](https://github.com/getkirby/kirby/issues)** – Report bugs and other problems.
- **[Feedback](https://feedback.getkirby.com)** – You have an idea for Kirby? Share it.
- **[Forum](https://forum.getkirby.com)** – Whenever you get stuck, don't hesitate to reach out for questions and support.
- **[Discord](https://chat.getkirby.com)** – Hang out and meet the community.
- **[Mastodon](https://mastodon.social/@getkirby)** – Spread the word.
- **[Bluesky](https://bsky.app/profile/getkirby.com)** – Spread the word.

---

License
-------

[](#license)

MIT

Credits
-------

[](#credits)

- [Kirby Team](https://getkirby.com)

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity30

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 66.7% 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 ~179 days

Total

4

Last Release

1097d ago

Major Versions

1.0.1 → 2.0.02023-01-17

PHP version history (2 changes)2.0.0PHP >=8.0.0 <8.2.0

2.0.1PHP >=8.0.0 <8.3.0

### Community

Maintainers

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

![](https://www.gravatar.com/avatar/38dee61adefb0d9fae59254a74cdaf33d8b4fcac96b451b9f9c46e0ab3ec1279?d=identicon)[distantnative](/maintainers/distantnative)

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

![](https://www.gravatar.com/avatar/910e459690c98761ff47c8f5b0af29b440005ed926b2f386a2aeb033030d35e8?d=identicon)[lukasbestle](/maintainers/lukasbestle)

---

Top Contributors

[![bastianallgeier](https://avatars.githubusercontent.com/u/24532?v=4)](https://github.com/bastianallgeier "bastianallgeier (10 commits)")[![afbora](https://avatars.githubusercontent.com/u/3393422?v=4)](https://github.com/afbora "afbora (4 commits)")[![distantnative](https://avatars.githubusercontent.com/u/3788865?v=4)](https://github.com/distantnative "distantnative (1 commits)")

---

Tags

componentscmstemplateskirbylayoutsslots

### Embed Badge

![Health badge](/badges/getkirby-layouts/health.svg)

```
[![Health](https://phpackages.com/badges/getkirby-layouts/health.svg)](https://phpackages.com/packages/getkirby-layouts)
```

###  Alternatives

[getkirby/cms

The Kirby core

1.5k535.5k350](/packages/getkirby-cms)[getkirby/kql

Kirby Query Language

15124.3k](/packages/getkirby-kql)[getkirby/starterkit

Kirby Starterkit

20612.3k](/packages/getkirby-starterkit)[getkirby/plainkit

Kirby Plainkit

11810.8k1](/packages/getkirby-plainkit)[leitsch/kirby-blade

Enable Laravel Blade Template Engine for Kirby 4 and Kirby 5

219.2k](/packages/leitsch-kirby-blade)[beebmx/kirby-blade

Blade template for Kirby

151.8k2](/packages/beebmx-kirby-blade)

PHPackages © 2026

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