Live Preview


Get to know the latest changes and updates to the 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?

v1.3.3 Latest

Released on July 15, 2024.

(No significant changes.)


Released on June 18, 2024.

๐Ÿš€ Features

  • New license management that allows activating licenses directly in the Panel.
  • Deprecated the private Composer repository in favor of Packagist.
Prior to v1.3, the plugin was published on a private Composer repository. It is now available on Packagist and can be installed without authentication. Your license key remains the same and is still required in production environments. To migrate your license key to the new location, follow these steps:
  • Remove the private repository configuration from your composer.json file and run composer update to install the latest version of the plugin.
  • Open a Panel page that contains the Live Preview section.
  • Your license key is is automatically migrated from the auth.json file in your root directory to the new location in the /site/config/.kirby-tools-licenses file.
  • Update your .gitignore file to exclude the new license file.
You can now delete the auth.json file from the root directory.


Released on May 20, 2024.

๐Ÿž Bug Fixes

  • Fit preview frame to Panel width even if aspectRatio is set.


Released on May 14, 2024.

๐Ÿš€ Features

  • Allow query language in help text.
  • Ignore any links that contain a hash as a redirect to the Panel.


Released on April 29, 2024.

๐Ÿš€ Features

  • Ignore links for Panel redirects that contain a data-preview-ignore attribute.

๐Ÿž Bug Fixes

  • Ignore same-page links for Panel redirects from the preview iframe.


Released on March 28, 2024.

๐Ÿš€ Features

๐Ÿž Bug Fixes

  • Rerender the preview frame on file sorting changes.


Released on 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.


Released on 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:
    [data-preview-mode] .cookie-banner {
      display: none;
    const isPreviewMode = document.documentElement.dataset.previewMode === "true";
  • Support preview mode detection in the backend with the previewMode content key:
    $isPreviewMode = $page->previewMode()->isTrue();


Released on March 23, 2024.

๐Ÿž Bug Fixes

  • Fix encoding issues with UTF-8 characters in the content fetcher proxy.


Released on March 22, 2024.

๐Ÿš€ Features

  • Inject <base> tag into the preview iframe to ensure relative asset URLs work correctly.


Released on March 22, 2024.

๐Ÿž Bug Fixes

  • Add default background to preview embeds.


Released on March 22, 2024.

  • Initial release of the Kirby Live Preview plugin.