Skip to content

Kirby 3.9.8

Page

The Page preset simplifies the setup for standard pages with form fields, optional subpages and files.

Do not use presets for new projects. Presets will be deprecated in future versions of Kirby.

Basic setup

This allows you to create a very basic blueprint like this:

title: Page preset example
preset: page

This simple blueprint creates an empty main section and a sidebar with a files and a pages section.

You can now extend this basic preset by adding as many fields as you like:

title: Default
preset: page

fields:
  intro:
    type: textarea
    size: small
  text:
    type: textarea
    size: small

Empty

Filled

And you can of course extend this basic setup in many ways.

No files or pages section

If you don't want a files or pages section, set either option to false in the page options:

No pages section:

pages: false

No files section:

files: false

Extend files/pages sections

You can extend the pages and files sections with the options available for pages sections and files sections.

Pages section

pages:
  template: default
  max: 10
  min: 1

Files section

files:
  template: image
  min: 4
  max: 8

Overwrite the sidebar

You can also overwrite the sidebar column:

#  Only an image section
sidebar:
  images:
    extends: sections/images

In this example, we extend an existing files section which we have defined in /site/blueprints/sections/images.yml. Instead of extending a existing files section, you can also define a complete files section here.

# Image section and additional fields
sidebar:
  meta:
    type: fields
    fields:
      date:
        type: date
        time: true
        default: now
      author:
        type: users
      tags:
        type: tags
        options: query
        query:
          fetch: site.tags.toStructure.sortBy("name", "asc")
          text: "{{ structureItem.name }}"
          value: "{{ structureItem.value }}"
  images:
    extends: sections/images

The main column can only take fields, the sidebar can have multiple sections of different types. Completely custom layouts are possible with layout blueprints.