# Upgrade to a new version

{% hint style="warning" %}
This guide will help you update your theme from version tf-4.0 or newer to the latest version. If you are using a version older than tf-4.0, please refer to [this guide](https://beloria-docs.boostheme.com/upgrade-to-a-new-version/old-upgrade-to-a-new-version) for more details.
{% endhint %}

{% hint style="warning" %}
Please note **that upgrade can not bring all advance customization works** (modified our theme files or app integration) which are done by 3rd apps, our team, or your team. To avoid any risk, **you should create a backup of the current theme first**.
{% endhint %}

When our item has a new version, you will receive an updated email from Envato and visit [https://themeforest.net/download](https://themeforest.net/item/vodoma-fastest-multipurpose-shopify-theme/25971898)

You can download our theme again and extract it to see the theme upload package (like when you used the previous version). Please follow some steps below to understand how to upgrade our items from the old version to the new version. it takes only 1 minute to update.

If you have customized the old version (such as hiring a developer to write new features or customizing our theme) so that the upgraded version cannot carry these codes, you will need to migrate all the custom code by hand.

## **1. Step 1: Download the latest package**

If you buy our themes from ThemeForest, log in to ThemeForest by the account you have used to buy our theme. Then download the latest theme package. If you don't know how to do that, please refer to this page <https://help.market.envato.com/hc/en-us/articles/202501014-How-To-Download-Your-Items>.

## **2. Step 2: Upload a new theme file from your computer**

Extract the package you download in step 1, then browse to the "**Theme files**" folder. Find and upload the theme file corresponding with the current theme on your site. You can refer to [this guide](https://beloria-docs.boostheme.com/broken-reference) to upload a theme in Shopify.

## 3. **Step 3: Copy the settings data**

Click the "**Actions**" button of the old theme, chose "**Edit code**".

Find and open the "**settings\_data.json**" file in the "**config**" folder.

![](https://3226993373-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHzCBtSR9PxRIkTBmO1%2F-Mi9YXg71I2n1cXKTTC4%2F-Mi9ZeS6b8LaLJzjIlFX%2Fimage.png?alt=media\&token=0351f33e-67e7-4cc3-b271-0573a79766a9)

Then copy all the content of this file. Then open the "**settings\_data.json**" in the new theme, and replace all content in this file by the content you copied.

## 4. **Step 4: Copy templates data**

Back to **the old theme,** browse and open the **Templates** folder. You will see a list of JSON files. A JSON file contains data of a template. Just copy the content of JSON files in the old theme and paste them to the same JSON files in the **Templates** folder of the new theme.

![](https://3226993373-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHzCBtSR9PxRIkTBmO1%2F-Mi9YXg71I2n1cXKTTC4%2F-Mi9Zm2SS5eoLIcCfrPu%2Fimage.png?alt=media\&token=10a3b0b9-c117-450c-b95b-96edf629f280)

You can use the following JSON templates in your theme:

* [404](https://shopify.dev/themes/architecture/templates/404)
* [article](https://shopify.dev/themes/architecture/templates/article)
* [blog](https://shopify.dev/themes/architecture/templates/blog)
* [cart](https://shopify.dev/themes/architecture/templates/cart)
* [collection](https://shopify.dev/themes/architecture/templates/collection)
* [index](https://shopify.dev/themes/architecture/templates/index-template)
* [list-collections](https://shopify.dev/themes/architecture/templates/list-collections)
* [page](https://shopify.dev/themes/architecture/templates/page)
* [password](https://shopify.dev/themes/architecture/templates/password)
* [product](https://shopify.dev/themes/architecture/templates/product)
* [search](https://shopify.dev/themes/architecture/templates/search)

## 5. Step 5: Copy translation

Back to Online Store, Click the "**Actions**" button of the old theme, chose "**Edit code**".

Find and open the **Locales** folder.

![](https://3226993373-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHzCBtSR9PxRIkTBmO1%2F-Mi9YXg71I2n1cXKTTC4%2F-Mi9ZqxmkGyoFwt-rwg3%2Fimage.png?alt=media\&token=becdfd58-622c-4eb9-afbe-4bdc46766081)

Open and copy the content of the file corresponding with the language you want to move to the new theme. Ex: en.default.json for English, fr.json for French,... Then paste the content you copied to the same file in the new file.

{% hint style="info" %}
Please note: If there are custom tasks that I helped you with on the old version, you have to copy all contents from the Assets > custom-css.scss.liquid to the new version.
{% endhint %}

##