# Update theme

Regular updates are released to fix bugs, add new features, and improve performance and code quality. You can check for new versions on the [**Changelog**](/docs/breeze/changelog.md) page.

If an update is available, download the latest version from your purchase receipt or directly from your [**Gumroad Library**](https://gumroad.com/library).

### How to Update the Theme

{% stepper %}
{% step %}
Download the latest ZIP file from your Gumroad receipt or Gumroad Library.
{% endstep %}

{% step %}
In Ghost Admin, go to **"Theme"** and download your active theme as a backup (optional).
{% endstep %}

{% step %}
Click **"Change theme" and  "Upload theme"**, then select the new file you downloaded.
{% endstep %}

{% step %}
After the upload finishes, click **"Overwrite"**.
{% endstep %}
{% endstepper %}

### Notes

* Your content and settings (logo, navigation, custom settings, etc.) are preserved during the update.
* If you've customized the theme code, consider saving a copy and manually merging changes before updating.
* For advanced users: use a Git-based workflow to track changes and apply updates selectively.

Although you're free to customize the theme code however you like, we've designed Breeze to be as flexible as possible - covering a wide range of use cases without requiring major code changes.

Unless you're an experienced developer, we recommend avoiding structural modifications to the theme, as this can make it harder to apply future updates smoothly.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pinathemes.gitbook.io/docs/breeze/advanced/update-theme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
