How to update from the 3.x version

All of your theme data and settings are stored in JSON files located in the templates, sections and config folders. Please note that Shopify does not provide automatic file migration, so all changes must be transferred manually.

When updating your theme, please note that every store may have unique customizations. Because of this, we do not include ready-made diff files in the package. Each store may be running a different starting version (for example, 3.0.0 up to 3.x.x), so the differences in code will not be the same for everyone.

This guide will help you compare your current theme with the newest version and update only the parts you need – without losing your custom code. There is also an automatic update method, but it may overwrite your customizations and app integrations, so we recommend caution. The automatic method is described at the end of this guide.

Before starting, check whether you actually need the update. You can review all changes in the Changelog section on Wokiee themeforest (at the end of the Wokiee product page). If the update does not affect features you use — you can simply skip it and save time.


Step 1 - Manual theme transfer

If you prefer not to download the old theme to transfer files, you can install the new theme and copy the JSON files directly from the old theme by copying them.

  1. Open the old theme in Edit Code.

  2. Open the new theme in Edit Code.

  3. Open the JSON files in the old theme, copy their content, and paste it into the corresponding files in the new theme.


This method allows you to move all your settings and data without downloading the entire theme.


Step 2 — Quick transfer

Download your old theme and the new theme to your computer, then copy the necessary JSON files from one to the other. After that, upload the updated theme back to your store. This approach is faster and more efficient.


Step 3 — If you need to save your custom changes in files

Download your old theme and the new theme to your computer, then copy the necessary JSON files from one to the other.

Then use the Github service. All is described below.

Files for Comparison

  • You should use the Git for these purposes

  • Create a new folder on your computer (for example on drive C:).

  • Please, download this software and install it - https://git-scm.com/downloads

  • Copy your current theme and the latest theme version into this folder.

Create another folder inside it named diff:

Copy your current working theme into the diff folder.

Then, right-click inside the folder and select GIT BASH HERE:


Initialize a Local Git Repository

Run these commands one at a time:

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

Then:

git init
git add .
git commit -m "User version"

Next, delete all files in the diff folder and replace them with files from the new theme version.

Run:

git add .
git commit -m "New version"


Generate the Diff File

To view commit IDs, run:

git log

Use the first commit ID as the starting version, and the second as the new version, and run:

git diff starting_version_code..new_version_code > userversion_to_newversion.diff

Example illustrated:

  • Copy text and set it on the second place:

After running the command, your diff folder will contain a file with all code differences:

Open it in Notepad++ or another code editor for best readability.


Apply Changes to Your Theme

  • Open your store and create a duplicate of your current theme (backup).

  • Compare the diff file with your theme files, updating only the parts you need.

This step requires attention and comfort working with theme code. This is not a quick process, especially if your theme has many customizations. Optional — Faster Method (Will Remove Customizations)

  • Make all changes in a new version.

  • And upload it on your domain where your theme is located

  • You can transfer your theme settings by copying JSON files from the old theme to the new one. Either open both themes in Edit Code and copy the files, or download the old theme, copy the JSON files, and upload the updated theme back to your store. This lets you move all settings safely without affecting the live theme.


To sum up, we can highlight the following: If you are not concerned about custom code, and you don't need to use the Git you can update your theme more quickly - simply copy all JSON files from the templates, sections, and config folders of your old theme and paste them into the corresponding folders of the new theme.

Last updated