Migration from 2.x to 3.x version

Starting with the version 3.0, the theme supports Shopify’s OS 2.0 which brings a major change in the theme structure and code. Because of that the update process includes more steps which are outlined below.

  1. From your Shopify admin, go to Online Store > Themes and click on 'Upload theme' button.
  2. From the Upload theme popup window, click Choose File to select the new version of the theme (Universe-vX.X.zip) from your computer. Click upload and you will see the new theme in 'Theme library' section
  3. Copy and replace the theme settings from the current theme to the new one. Click 'Edit Code' in the 'Actions' dropdown of Live theme, open /config/settings_data.json file, select everything and copy. Then go to /config/settings_data.json file of the new theme and paste the settings.
    Note: please make sure to remove '"checkout_use_storefront_logo": true,' line from your settings_data.json, otherwise it might cause an issue with using a custom logo on the checkout page.  

    Due to a major change in the theme structure you will need to setup custom pages and the product page template manually: click customise next to the new theme > in the theme editor select the page template to edit > add sections and adjust settings to match your current store.

  4. Optional. If you have any apps installed that add code you the theme, please check their documentation and most likely you will need to reinstall them to setup with the new theme.
  5. Optional. Migrate any custom code that you ever added to your Liquid files, otherwise the changes will get lost. Simply copy and paste custom code the same way you just did with theme settings. Note: if you have any custom CSS code in ‘assets/custom.css.liquid’ file, in the new version you should put the code in ‘/assets/universe.css’ file.
  6. When you're done with migration, preview the new theme and if all looks good - click 'Publish' to make the new version of the theme live on your store.

Still need help? Contact Us Contact Us