Updating Publii

The Publii team is constantly working on implementing new features, improving the existing ones, and fixing any bugs that are found, so there are regular updates released to help improve the Publii user experience. In this section we'll cover how to update your app, as well as your bundled themes.

Update notifications

When a new update is released, Publii can notify you that it is available and provide links to download it and find further information. To receive these notifications, you need an internet connection and the notifications centre must be enabled.

Open Notifications from the menu in the top-right corner of the app. If notifications are not enabled, you can enable them there. You can also manage this preference in App settings. To check for updates manually, click Check for updates in the Notifications screen.

Updating your app

To update Publii, download the latest version and install it over your existing installation. The steps depend on your operating system:

1. Go to the Download Page and download the latest version of Publii for your operating system. On macOS, choose the version for your Mac's processor: Intel or Apple silicon.
2. Save your work and close Publii before installing the update.
3. On Windows, run the downloaded installer. On macOS, open the DMG file and drag Publii into your Applications folder, replacing the existing app when prompted. On Linux, install the new DEB or RPM package using your package manager, or replace your existing AppImage with the new file and make it executable if necessary.
4. Open Publii once the update is complete.

Your websites and settings are stored separately from the application, so you don't need to recreate them after updating.

Updating your theme

Often, new releases of Publii will also include updates to the bundled themes. These newer versions are added to your theme library when you update Publii, but they are not automatically applied to your existing websites. There's an additional step required to update the theme used by each site.

Open the site's Site settings. When a newer version of its active theme is available in your theme library, click the Update to button beside the theme selector, then click Save settings to apply it to that site.

For updates available from the Publii Marketplace, open Themes from the menu in the top-right corner of the app. When update information is available, the theme's card shows the latest version and a Download update or Open my downloads button. Download the theme ZIP file and install it to update your theme library, then apply the update to your site as described above.

After updating a site's theme, preview your website to check the result, then sync it when you're ready to publish the changes.

For a full step-by-step guide to theme updating, and a breakdown of how it works, visit the Installing and Updating Publii Themes article.