Update a theme to a newer version

Why update? 

We occasionally release new versions of themes for a few reasons: bug fixes, feature additions, or platform updates. To find out what the current version of the theme you're running, you can view your theme's changelog: 

Maker Changelog
Blockshop Changelog 

Mosaic Changelog

While it can take a bit of time, updates can be well worth it. They can resolve bugs that affect your store and may contain additional features and updates to core functionality.

If you have a heavily customised store, updating can be a little trickier, so make sure updating will be worth your while, by checking the theme's changelog for details on the releases. 

"Do I I have to re-customize my theme from scratch?"

Currently, there’s no way to automatically update your theme. Automatic updates would create a lot of broken apps and missing customizations. If you’d like a new version of the theme, you will need to upgrade it manually. 

Updating your theme will reset any presets you have changed, as well as overwrite any custom code you have.  You will need to re-apply your theme settings (logo, slideshow images, colours & fonts, etc) and any other customizations you've made to the theme. The majority of the settings affect the main elements of the theme, such as the header, footer and storefront layouts.

You won't need to re-upload products, descriptions, blogs or any other content set up in the backend. 

Step-by-step Updating Process 

  1. Download a copy of your new theme file

    If you purchased the theme via the Shopify Theme store
    Follow Shopify's instructions on how to download an up-to-date copy of your theme from the theme store. 

    If you purchased the theme directly via our store:
    Revisit the unique download link you received when you first purchased the theme and download the latest version from there. 

    Once you have uploaded the  theme zip file, it will appear as unpublished on the Themes page of your dashboard.

  2. Download a copy of your current theme

    You can download a copy of your current published theme in your theme dashboard under the edit menu:

    Shopify will email you a .zip file of your current theme.

    Once downloaded, unzip it and take a look at the contents in your assets folder. Here you'll find all the images from your current theme that you will need to re-upload to the new version.    


  3. Reapply theme settings

    A fast way to reapply the theme settings from one theme to another is to open two browser for both the current (published) and new (unpublished) themes. Placing them side-by-side in allows you to cross reference section by section and match the settings.

    You can find your store images in the assets folder you downloaded in the previous step.    

  4. Migrate custom code

    If you had made customisation to any of the theme's template files or added custom CSS via the template editor, you'll want to transfer those across. 

  5. Reinstall Apps

    Any apps that add code to your theme’s files will need to be reinstalled. You’ll need to find the app documentation to follow the installation instructions on how to do this. If you’re unsure how, you can go to Apps and click 'View Details' to find the support email for that Shopify app.

  6. Publish theme 

    One you’ve migrated all your settings and custom code, you’re set to go.
    When you Publish the new version of the theme, the old version will be stored in your dashboard and you can revert back to it at any time.  

Still need help? Contact Us Contact Us