# Update Zest theme

Each Zest theme purchase includes all future versions of that theme. Regular releases for new versions provide bug fixes, added features, platform requirements, or other improvements.

> The most up-to-date version of the theme is available on [Shopify Theme Store](https://themes.shopify.com/). 

{% embed url="<https://themes.shopify.com/themes/zest/presets/zest?utm_source=foxecom&utm_medium=help_center_zest_update_zest_theme&utm_campaign=cta_button>" %}

***

{% hint style="info" %}
The [**Color schemes**](https://help.shopify.com/manual/online-store/themes/theme-structure/color-scheme) feature is available from **Zest version 7.0.0 and above**.&#x20;

If your current theme version is older, make sure you <mark style="background-color:green;">migrate data for this feature</mark> following this article:\
[how-to-migrate-your-zest-theme-to-version-7.0.0](https://docs.foxecom.com/zest-theme/faqs/generic/how-to-migrate-your-zest-theme-to-version-7.0.0 "mention") 🌟
{% endhint %}

{% hint style="warning" %}
All code customizations in your theme are **not transferred** to the new theme version **by default**.&#x20;

You need to duplicate and move the code to the new version yourself.
{% endhint %}

## Update the theme

In your Shopify admin, open the **Themes** page of your **Online Store**.

When a theme update is available, a notification will appear in your theme library.&#x20;

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FJilduMIFDcUCAovmTDLw%2Fimage.png?alt=media&#x26;token=ec18da58-73d8-44a5-80a3-4aebf70ad7df" alt=""><figcaption></figcaption></figure>

Click on the notification to read more details.

Then, select **Add to theme library** to add the updated version to your theme library, or select **View release notes** to read the new release details.

{% hint style="info" %}
You can work on your theme in the theme library before you publish it. Adding a new theme to your theme library doesn't impact your current theme or any other themes in the library.
{% endhint %}

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2F6ANjgiPDIm77FMDjgKWB%2Fimage.png?alt=media&#x26;token=176cf378-8742-4bba-87db-9daf560d78da" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Any customizations made to your theme using the theme editor are copied over and applied to the updated theme. These include the following modifications:

* Changing theme settings
* Altering page layouts, such as adding, reordering, removing, or hiding sections or blocks
* Changing section or block settings, including adding images, videos, text, and data sources
* Creating new templates
* Adding, removing, or changing the settings of app embeds or app extensions
* Making [changes to wording on your online store using the theme content editor](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/language/change-wording)

If you or an installed app have made any [code changes](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/edit-code/edit-theme-code) to your theme, then you're informed that **Your code changes won't be included** in the updated version. If you want to keep these changes, then you need to copy your code to the new version of your theme or reconfigure some apps.
{% endhint %}

{% hint style="warning" %}
Any limit and constraint change to a theme's schema, such as increasing the block limit of a section or reducing constraints on where some sections can be added, might result in an update failure.
{% endhint %}

When your theme is on the latest available version, a status message of **This theme is up to date** is displayed.

## Can't see the update notice?

If you don't get an automatic update notice for your theme, then you won't be able to update the theme using the standard update process. &#x20;

This can happen if:

* You’ve changed the theme’s code and it conflicts with the update system, or
* The theme was installed manually.

To fix this:

* **Re-install the theme** and update it manually.
* Remember: **Any custom code or third-party app snippets won’t transfer** to the new version. Copy any needed changes and reapply them.
* For apps, **contact the app provider** to help re-install or reconnect them.

Steps on updating the theme manually:

{% stepper %}
{% step %}

### Create a backup of your current theme

Duplicate your work before attempting any theme update.&#x20;

If you encounter any errors, you can use the duplicated (backup) version to restore to the original function and styling.

{% hint style="success" %}
**Steps**

1. In your Shopify admin > **Online store**, click **Actions**.
2. Select **Duplicate**.
3. Rename the copied file.
   {% endhint %}
   {% endstep %}

{% step %}

### Upload the latest Zest theme version

Check and download the latest version of Zest from [Shopify Theme Store](https://themes.shopify.com/themes/zest/presets/zest?utm_source=foxecom\&utm_medium=help_center_zest_update_zest_theme\&utm_campaign=anchor_text\&utm_term=shopify_theme_store).&#x20;
{% endstep %}

{% step %}

### Move the theme settings and your pages

{% hint style="success" %}
**Steps:**

1. Locate your old theme > select **Actions** > **Edit code.**
2. Copy the content of the following files from the current theme and paste them into the same folders in the new version. These files include:
   * All *edited* JSON files in the **Templates** folder
   * The settings\_data.json file in the **Config** folder.
3. Re-implement your code modification works (if any).
   {% endhint %}

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FVWvgpaDODnhNrG66ckYu%2Fimage.png?alt=media&#x26;token=6cf554cc-3c9b-4fc1-bfdf-2fd8aeacccc5" alt=""><figcaption></figcaption></figure>

For custom templates, you'll need to create the JSON template in the new theme files since they won't exist there by default. More details [here](https://help.shopify.com/manual/online-store/themes/theme-structure/templates#create-a-new-template) from Shopify on creating new templates in the theme.
{% endstep %}

{% step %}

### Re-install apps <a href="#h_01f688nf9yn2g76wb9kxarp7e7" id="h_01f688nf9yn2g76wb9kxarp7e7"></a>

Any apps that add code to your theme's files will need to be re-installed. This can be an automatic or manual process depending on the app, so **confirm with the app's developer whether removing and adding the app is enough to connect with the new version.**

Find the app documentation in the [App Store](https://apps.shopify.com/) to follow the installation instructions.&#x20;

If you're unfamiliar with this process, you can go to **Apps >** click **View details** to find the support email for that Shopify app.
{% endstep %}
{% endstepper %}

***

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FvMX5cFtFh5GV33JWStcB%2FE11.jpg?alt=media&#x26;token=6fbfc448-93c3-4bd7-9551-4cad1ecbf620" alt=""><figcaption><p><a href="https://www.figma.com/community/plugin/1415136291103675876/figma-to-shopify-with-foxify-shopify-page-builder?utm_source=help+center&#x26;utm_medium=banner&#x26;utm_campaign=figma+to+shopify+fxf+launch">Use free now </a><span data-gb-custom-inline data-tag="emoji" data-code="26a1">⚡</span></p></figcaption></figure>

<br>


---

# 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://docs.foxecom.com/zest-theme/getting-started/update-zest-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.