Updating
We take great care to make Zero One updates as safe and straightforward as possible. In most cases, updating is simply a matter of replacing a few folders and files.
If you are updating from a version older than the oldest version documented in the changelog, please get in touch with us before updating.
Before You Update
Create a Backup
Before any update, create a backup of your website files.
If you are unsure about any update step, having a backup allows you to quickly revert to a working version.
Never Overwrite Your Content
Never overwrite the content/ folder.
This folder contains your website content, pages, files, and uploaded media.
Review Custom Changes
Be careful when updating:
site/config/website configuration filessite/languages/website language(s)site/theme/custom overrides (if you have any)
If you made custom modifications to these files, compare them with the new version before overwriting anything.
Understanding Updates
Not all updates are the same.
Each release in the changelog is marked with an update type.
🟢 Standard Update
A routine update that usually only requires replacing the files and folders listed in the changelog.
No additional manual steps are required unless stated otherwise.
🟡 Configuration Update
Requires one or more manual configuration changes in addition to updating files.
Examples include:
new configuration options
updated configuration settings
new panel options
asset-related settings
Configuration Updates should not be skipped.
🔴 Migration Update
Requires manual changes beyond normal file and configuration updates.
Examples include:
structural theme changes
template or blueprint changes
plugin migrations
asset restructures
compatibility-related changes
Migration Updates must never be skipped.
Which Instructions Should I Follow?
When updating from an older version:
Complete all 🔴 Migration Updates released after your current version.
Follow the instructions from all 🟡 Configuration Updates released after your current version.
Finally, update to your target version.
Example
Current version: 5.1.0
Latest version: 5.4.1
Required Updates
🔴 Update to 5.2.0 (Migration Update)
🟢 Update to 5.4.1 (Standard Update)
Additional Instructions Required
Before updating to 5.4.1, also follow:
🟡 Configuration Update instructions from 5.3.0
🟡 Configuration Update instructions from 5.4.0
Important
🔴 Migration Updates must be completed in order.
🟡 Configuration Updates do not require installing that version, but their instructions must be followed.
🟢 Standard Updates can be safely skipped unless they are your target version.
Standard Update Procedure
Most Zero One updates require updating some or all of these:
assets/kirby/site/plugins/composer.json
The exact files and folders are always listed in the changelog entry.
Simply follow the update instructions for the specific version you are installing.
After Updating Assets
If the update includes changes to the assets/ folder:
Open the Site Styling section in the Panel.
Enable Style Compiler.
Save.
Open or refresh any frontend page.
Wait for the stylesheet to be regenerated.
Disable Style Compiler.
Save again.
Alternative Update Method
Some users prefer updating by starting with the new Zero One version and moving their existing content into it.
The process is:
Download the latest Zero One version.
Create a backup.
Copy your existing
content/folder into the new installation.Review any custom configuration changes before going live.
This is entirely optional but can be useful when performing larger upgrades.
Need Version-Specific Instructions?
All release-specific instructions, migration steps, fixes, and new features are documented in the Changelog.
👉 Read the changelog before every update.
👉 Get in touch with us for specific instructions.
Last updated