Kirby 3.1.0 – Chamaeleo is here!

Introducing 3.1 - Chamaeleo

We are very excited to share our first major 3.x release with you and release it into the wild: Say hello to 3.1 - Chamaeleo! :tada:

A word on our release schedule:
We set out the goal for Kirby 3 to work with a much quicker release cycle, in short: bi-weekly minor releases for bug fixes, bi-monthly major releases for features. We are quite happy to see that this has all worked out so far and we feel very good moving forward like this. We hope you do too - you can follow our release schedule here:

So let’s dive into what 3.1 - Chamaeleo is all about:

Conditional fields

We know, this has been on your lists for a while - even way back in v2. A lot of the efforts that went into the groundwork of Kirby 3 is paying off now and we are happy to tell you that a first version of conditional fields is finally here and here to stay:

    label: Category
    type: select
      a: A
      b: B
      c: C
      other: Other …
    label: Enter your category
    type: text
      category: other

We wanted to start with a basic version but will include more possibilities to it in upcoming releases.

File uploads in textareas

Select and upload files right from the textarea field (via dropdown or drag’n’drop)

Srcset support

  src="<?= $image->url() ?>"  
  srcset="<?= $image->srcset([300, 800, 1024]) ?>" 
  alt="<?= $image->alt() ?>">

Inline KirbyText

Render kirbytext and markdown without wrapping the text in a <p> tag with $field→kirbyTextInline() and kirbyTextInline()

… and a lot more.

You can find a full list of all the features, improvements and fixes:


How to update

  1. Download the latest version of the kirby folder here:
  2. Unzip it and rename the folder to kirby
  3. Use it to replace your old kirby folder in your installation

We are looking forward to hearing what you think. Have a great day!


I guess we could also have named this “v2 desires”: conditional fields, kirbytext without <p> tags, srcset support – ringing bells of issues from some time ago. Good things come to those who wait (or: why a lot of efforts in building v3 are paying off now) :smiley:


I have seen, you did today “Fix some blueprint issues” in the starterkit K3.

Should we do something else in your K3 projects?

Fantastic update! Great job to the whole team! :clap:


All of those changes are purely cosmetic fixes to improve the consistency of the example blueprints.


Thank you for this information.

OMG, Conditional Fields! I just teared up a little… :joy:


At last, conditionnal fields!

Ever since Kirby 3 released, I’ve been dying to use it on a client projet. I haven’t had the chance yet, and the 3.1 release has made me even more excited to use it.

Great job everyone!


I am super stoked about these changes. Geeking out here.
It’s looking so good! Can’t wait to update.