> For the complete documentation index, see [llms.txt](https://www.one.thezero.club/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.one.thezero.club/guide/installation/updating.md).

# 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.

Updating Zero One usually takes about 15 minutes. You replace a few folders on your website with new ones from the download, then click a few buttons in the Panel.

This page explains how to do it safely. You don't need to be a developer.

{% hint style="info" %}
**Not comfortable doing this yourself?** [Contact us](https://www.one.thezero.club/support.md). We're happy to help.
{% endhint %}

### Before you start

You'll need:

* **The new Zero One download** from your [Gumroad library](https://gumroad.com/library)
* **Access to your website files.** This is usually through your hosting control panel's "File Manager", or an FTP app like [FileZilla](https://filezilla-project.org/) or [Cyberduck](https://cyberduck.io/). If you're not sure how, ask your hosting provider.
* **Access to the Panel** (your website's admin area at `yourwebsite.com/panel`)

### Step 1: Make a backup

A backup is a full copy of your website. If anything goes wrong, you can put everything back the way it was.

The easiest way is to **ask your hosting provider to make one**, or use the backup button in your hosting control panel. You can also download your whole website folder to your computer.

{% hint style="danger" %}
**Never replace or delete the `content` folder.** It contains all your pages, text, and images.
{% endhint %}

### Step 2: Find your current version

Go to **Panel → System.** You'll see your version number, for example, **5.4.1**.

<figure><img src="https://1582165953-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4ZpEbnFxt2CBoFZg0N%2Fuploads%2Fnc6z3oekQnE084WaJTPz%2Fscreenshot-zero-one.test-2026.10.15-16_56_59.png?alt=media&amp;token=8a260740-fd95-45cd-873e-d2cc5258b164" alt=""><figcaption></figcaption></figure>

### Step 3: Find your update steps

Open the [Changelog](https://www.one.thezero.club/changelog.md) and find your version in the **"Find your update path"** table. It tells you exactly which updates to follow, in which order.

Each update in the changelog is marked:

| Mark                           | Meaning                                                       |
| ------------------------------ | ------------------------------------------------------------- |
| 🟢 **Simple update**           | Just replace the files listed                                 |
| 🟡 **Update with extra steps** | Replace the files, then follow the extra steps in that update |
| 🔴 **Major update**            | Needs special care. Follow every step, and don't skip it      |

<details>

<summary>Why do I need to follow older updates?</summary>

Some updates change how settings or content are stored. If you jump straight\
to the newest version, those changes would be missed. That's why the table\
lists every 🟡 and 🔴 update since your version, in date order.

For 🟡 updates, you don't need to install that version. You just do its\
"Required even if you skip this version" steps. 🔴 updates must be installed\
and completed one by one.

</details>

### Step 4: Replace the files

The [changelog](https://www.one.thezero.club/changelog.md) lists which folders and files to replace. Do this for **each one**:

1. On your website, **rename** the old folder by adding `-old` to its name. For example, rename `kirby` to `kirby-old`.
2. **Upload** the new folder from the Zero One download to the same place.

{% hint style="warning" %}
**Don't upload the new folder on top of the old one.** Most FTP apps and file managers mix the old and new files together, and that can break your website. Renaming the old folder first avoids this.
{% endhint %}

{% hint style="info" %}
**Did you add plugins of your own?** If the changelog says to replace the `site/plugins` folder, replace only the Zero One plugins inside it: `zero-one`, `kirby-form-block-suite`, `code-editor`, `similar`, … Leave any others in place.
{% endhint %}

{% hint style="info" %}
**Did you change any theme files yourself, or did a developer do it for you?** Then contact that person, or contact us, before updating `site/theme` or `site/config`.
{% endhint %}

### Step 5: Refresh your website's styles

1. Log in to the Panel and go to **Site → Styling**.
2. Turn on [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling.md#turn-the-styling-on-off) and click **Save**.
3. Open your website in a new tab and refresh any page. Wait a few seconds.
4. Back in the Panel, turn off **Style Compiler** and click **Save**.

### Step 6: Check that everything works

* [ ] You can log in to the Panel
* [ ] The Panel shows the new version number
* [ ] Your homepage and a few other pages look normal
* [ ] Your contact form sends a message
* [ ] If your site has several languages: check a page in each language

**Everything works?** Delete the `-old` folders.

**Something looks wrong?**

1. Delete the new folder you uploaded.
2. Rename the `-old` folder back to its original name. For example, rename `kirby-old` back to `kirby`.
3. [Contact us](https://www.one.thezero.club/support.md) and tell us your old version, the new version, and what you see (a screenshot helps).

Your website will be back the way it was.

***

### For developers

<details>

<summary>Composer</summary>

If you manage dependencies with Composer, run `composer install` after replacing `composer.json`. \[Add any note about `composer.lock`.]

</details>

<details>

<summary>Files that may contain your own changes</summary>

| Location          | What to check                                          |
| ----------------- | ------------------------------------------------------ |
| `site/config/`    | Custom settings and `.license`. Merge, don't overwrite |
| `site/languages/` | Custom languages and translations                      |
| `site/theme/`     | Your overrides                                         |
| `site/plugins/`   | Third-party plugins                                    |
| `assets/`         | Custom fonts or files                                  |
| `.htaccess`       | Custom server rules                                    |

</details>

<details>

<summary>Clearing the cache</summary>

If pages still show old content after updating, clear the cache from \[Panel option] or delete the contents of `site/cache/`.

</details>

<details>

<summary>Alternative method: fresh install</summary>

Start from the new Zero One version and move your data into it. Copy from your old site:

* `content/`
* `site/accounts/` (Panel users; without it, you can't log in)
* `site/config/` (including `.license`), merged with the new `config.php`
* `site/languages/`
* your overrides in `site/theme/`
* your own plugins in `site/plugins/`
* custom files in `assets/` and custom `.htaccess` rules

You still need to complete every 🔴 and 🟡 step in your update path.

</details>

***

### Need Version-Specific Instructions?

All release-specific instructions, migration steps, fixes, and new features are documented in the Changelog.

👉 [**Read the changelog**](https://www.one.thezero.club/changelog.md) **before every update.**&#x20;

**👉** [**Get in touch with us**](https://www.one.thezero.club/support.md) **for specific instructions.**&#x20;
