Theme updates

Theme updates

Start your free trial
Start your free trial

General

Online store speed
Online store speed
Accessibility
Accessibility
Theme updates
Theme updates

Theme styles

Style presets
Style presets
Colors
Colors
Fonts
Fonts
Animation
Animation
Social media
Social media

Header

Announcement bar
Announcement bar
Mobile menu
Mobile menu
Search bar
Search bar

Sections

Products

Product listings
Product listings
Product badges
Product badges
Quick view
Quick view
Quick add
Quick add

Product page

Product template
Product template
Variant chips
Variant chips
Sticky add-to-cart bar
Sticky add-to-cart bar
Sibling product swatches
Sibling product swatches
Product recommendations
Product recommendations

Collection page

Collections template
Collections template
Banner
Banner
Product grid
Product grid
Filters and sorting
Filters and sorting

Cart

Quick cart
Quick cart
Cart page
Cart page
Added-to-cart popup
Added-to-cart popup
Cross sells
Cross sells
Free shipping bar
Free shipping bar
Low inventory warning
Low inventory warning

Pages

Templates
Templates
Home page
Home page
About page
About page
Blogs page
Blogs page
Blog post
Blog post
Collections list
Collections list
Contact page
Contact page
Password page
Password page
Search page
Search page
404 page
404 page

Support

Support policy
Support policy
Shopify vs Theme issues
Shopify vs Theme issues
Store access requests
Store access requests

Theme updates

Your theme will update automatically only to fix bugs or security issues. For major updates, or if code customizations and apps have been added to your store, Shopify does not automatically update themes.

This article shows you how to transfer your theme settings and templates faster and efficiently. However, custom code change and apps will need to be transferred by a developer or by re-installing apps. Our Support cannot cover manual theme updates, code customizations, or app integration.

Note | For details about the latest theme versions, you can read the release notes for Cornerstone on the theme listing page.

Watch video tutorial

Watch our video walkthrough for a step-by-step guide to update your theme:

Theme update notification

You will be notified of all theme updates in your Theme library. Major theme updates typically include feature releases or significant changes to the structure or settings of the theme.

Click on the notification to view the update details. Click Release notes or see the changelog to learn more about the update.

image
image

Step 1: Add the latest theme version

First, you will need to add the latest theme version before transferring your settings and templates.

For theme updates that are not updated automatically, here's how to add the newest theme:

icon
STEPS

In your Shopify Admin:

  1. If you haven't made code changes to your theme, click on the notification to open the details pop-up, and then click Add to theme library to add the updated version to your theme library.
  2. If the Add to theme library does not appear, or you've made code changes, you will need to install a fresh version of Cornerstone on the theme store for free.
  3. (Recommended) You can rename this new theme copy (Actions > Rename).
  4. (Recommended) Make a backup of your current theme (Actions > Duplicate).

Step 2: Open code editors for both themes

We are going to open the code editors for each theme in two separate windows to make it easier to transfer the theme files.

image
icon
STEPS
  1. Open two browser windows beside each other.
  2. In the left window, open up the code editor (Actions > Edit code) of the old theme.
  3. In the right window, open up the code editor (Actions > Edit code) of the new theme.

Step 3: Open old theme files

We will now open the files of the original theme version (not the duplicate). Green dots will mark the files that need to be transferred from the old theme. Note: This includes files that have been created for customized Contexts.

icon
STEPS
  1. Open the Templates folder. Files with green dots are templates that have been edited or added.
  2. image
  3. Click every .json file with a green dot in the order they appear to open them in their own tab.
  4. image
  5. In the Sections folder, open the files that you opened in the old theme, in the same order.
  6. These might include: header-group.jsonfooter-group.jsonoverlay-group.json. These files include settings for the Header, Announcement bar, Footer, and Popups.
    You will also need to open any files created for custom Contexts. For example: header-group.context.eu.jsonfooter-group.context.ca.jsonoverlay-group.context.it.json.
  7. In the Config folder, click to open the settings_data.json. This file contains the theme's global settings.
  8. image

Step 4: Set up new theme files

We will now open the same files in the new theme in the same order. If there are files that are in the old theme that don't exist in the new theme, you will need to add files with the exact same name. Note: This includes files that have been created for customized Contexts.

icon
STEPS
  1. In the Templates folder, open the same files that you opened in the old theme, in the same order.
  2. For templates that don't already exist in the new theme, click Add a new template and enter the exact same name as the file in the old theme.
  3. image
  4. In the Sections folder, open the files that you opened in the old theme, in the same order.
  5. These might include: header-group.jsonfooter-group.jsonoverlay-group.json.
  6. For sections that don't already exist in the new theme, click Add a new section and enter the exact same name as the file in the old theme.
  7. You will need to create any files for custom Contexts that are in your old theme. For example: header-group.context.eu.jsonfooter-group.context.ca.jsonoverlay-group.context.it.json.
  8. In the Config folder, click to open the settings_data.json.
  9. image
You now should have your theme files opened and ready for each theme version.

Step 5: Copy old theme files into new theme files

We will now copy and paste your old theme files into your new theme files:

icon
STEPS
  1. In both windows, select the first tab with the same filename (eg. blog.json)
  2. In the old theme (left window), select all of the file contents (cmd+a or ctrl+a) and copy (cmd+c or ctrl+c) the contents to your clipboard.
  3. In the new theme (right window), delete the current code, and paste (cmd+v or ctrl+v) everything from your old theme.
  4. Click Save in the new theme.
  5. Repeat this process for all open files. To keep track, you can close each tab once you've transferred and saved the new contents.
  6. Click Save when you're done.

That's it! Well done! Now you can close the code editors, and preview the old and new themes beside each other before publishing the new theme.

If there are new features listed in the changelog, you might want to consider adding those to your store in the theme editor.