> For the complete documentation index, see [llms.txt](https://foxecom.gitbook.io/zest-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://foxecom.gitbook.io/zest-theme/getting-started/update-zest-theme.md).

# 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/).&#x20;

{% 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](/zest-theme/faqs/generic/how-to-migrate-your-zest-theme-to-version-7.0.0.md) 🌟
{% 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="/files/rZyXpkNICwTBAQMIqMmH" 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="/files/gAgVBQ2PJe2lI2r6NXNw" 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="/files/U8LG8NEsmucCSVizdpKw" 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="/files/osE0TqmEK0BTYKBoIrie" 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>
