Kirby Tools
v2.4.1Hub

Changelog

All of the changes to the Kirby Live Preview plugin.

Where to Find the Latest Version?

If you have installed the plugin via Composer, you can update it by running the following command in your terminal:

composer update

If you have downloaded the plugin as a ZIP file, you can download the latest version from the releases page on GitHub.

What's New?

v2.4.1

July 11, 2025

🐞 Bug Fixes

  • Fixed plugin installation in projects without Composer.

v2.4.0

June 24, 2025

🚀 Features

v2.3.3

May 2, 2025

🐞 Bug Fixes

  • Throw exception if <head> tag is missing in the page template.

v2.3.2

April 6, 2025

🐞 Bug Fixes

  • Add compatibility with Kirby 5.0.0-beta.5.

v2.3.1

April 4, 2025

🐞 Bug Fixes

  • If a device preview is smaller than the preview section, prevent scaling it.

v2.3.0

April 2, 2025

🚀 Features

Live Preview section with device buttons
  • New button to open previews in a new tab.
  • Device dimensions buttons to simulate different screen widths. The height is fixed at 100% of the preview section. The available devices are:
    • Mobile: 390px
    • Tablet: 768px
    • Desktop: 1440px

v2.2.0

January 24, 2025

🐞 Bug Fixes

  • Unsaved content from site-level fields is now rendered in the preview.

v2.1.0

January 20, 2025

🚀 Features

  • New pageId section property to preview a page other than the current one.
  • Improved section height calculation for sticky previews when scrolling.

v2.0.0

December 20, 2024

Kirby Live Preview v2 is a major release with support for Kirby 5. This major release requires a new license key. If you already have a license, you receive either a free upgrade to v2 or a 50% discount on your new license. Head over to the Kirby Tools Hub to get your discount or read more in the license compatibility guide.

🚀 Features

  • Support for Kirby 5.

v1.5.0

November 15, 2024

🚀 Features

  • New updateStrategy to control the preview update behavior. If set to blur, the preview is updated when any Kirby text-like, number-like, or blocks field loses focus.

To change the default strategy from interval to blur, set the updateStrategy property in your blueprint:

sections/live-preview.yml
type: preview
updateStrategy: blur

v1.3.0

June 18, 2024

🚀 Features

  • New license management that allows activating licenses directly in the Panel.
  • Deprecated the private Composer repository in favor of Packagist.

v1.2.0

March 25, 2024

🚀 Features

  • Change rendering frequency with the updateInterval option or disable it completely.

🐞 Bug Fixes

  • Saving with Cmd + S now works correctly when the focus is on the preview frame.

v1.1.0

March 24, 2024

🚀 Features

  • Resolve permalinks in writer fields to redirect links to the corresponding Panel page.
  • Support detecting the preview mode in the frontend with the data-preview-mode attribute in CSS and JavaScript:
    assets/css/main.css
    [data-preview-mode] .cookie-banner {
  display: none;
}
    assets/js/main.js
    const isPreviewMode = document.documentElement.dataset.previewMode === "true";
  • Support preview mode detection in the backend with the previewMode content key:
    site/snippets/footer.php
    $isPreviewMode = $page->previewMode()->isTrue();

v1.0.3

March 22, 2024

  • Initial release of the Kirby Live Preview plugin.