Update a theme to a newer version

Why update? 

We frequently update our themes to include new options and features, support for new Shopify updates, performance improvements and bug fixes. 

How to update a theme

First of all, find out what version of the theme the store is running in the theme settings tab shown below:

Theme versions and their release details can be found in each theme's changelog:   

Blockshop changelog
Maker changelog
Local changelog

If you use a version that supports Sections (and you haven't made any changes to the files) your theme will update automatically. These updates are triggered by Shopify whenever a new version of your theme is released.

In most cases, if you have edited your theme files, added any Shopify Apps or made any custom changes you will need to manually update the theme.

We'll walk you through our recommended process for updating a theme manually below.

Note — Major theme updates may still require you to update manually. Please contact our support if you have any questions about updating between versions.

How to manually update a theme 

Install a new copy of the theme

If the theme was purchased through Shopify, an updated version can be downloaded at no charge from the Shopify theme store.

To do this, navigate to the theme listing page and click Add latest theme version. The theme will be added to the top of your Themes page in your store admin.

If you're not seeing the button above, check to make sure that you're logged into the same Shopify account as when you first purchased the theme. 

Update theme settings

Now it's time to reapply your customizations made in the theme settings. To speed things up, open the theme editor for both the published (live) and unpublished versions in separate tabs or side-by-side windows. Go through the new theme section by section and match the settings from the old version. Comparing the two helps you to familiarize with and set up any new features and settings.

Migrate custom code

If you have 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.

Reinstall Apps

Apps that required you to add code to your theme’s files will need to be reinstalled. You’ll need to revisit the app documentation and 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.

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.

Is there any way to avoid re-customizing my theme from scratch?

You can copy across theme customizations from the current version to a new version with a bit of handy work. 

From the Edit HTML/CSS page, under the Config folder, copy the content of the settings_data.json file from the current theme to the new theme.

This file contains all the values of customization in the theme's settings and will be carried across to your new version. 

Note — This is a faster way to reapply your customizations, but there may be some settings which don't carry over. Make sure you check over the new version in the storefront editor before publishing the theme. 

Still need help? Contact Us Contact Us