Upgrade to a new version

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 for more details.

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.

When our item has a new version, you will receive an updated email from Envato and visit https://themeforest.net/download

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

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.

You can use the following JSON templates in your theme:

• 404

• article

• blog

• cart

• collection

• index

• list-collections

• page

• password

• product

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

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.

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.