# Update to latest version

We update Cascade’s code regularly. Our updates provide Cascade with new and improved features, important security enhancements, and the latest bug fixes. Refer to Shopify help: Updating themes (opens new window).

Whenever we release a new version, Cascade updates automatically (unless the theme code was edited). If the theme code was edited, you must install updates manually by following this guide.

# Update Cascade manually

To update Cascade manually, go to the Cascade theme page on Shopify’s Theme store (opens new window)

If you’re signed in to Shopify, Cascade’s theme page will display an Add latest theme version button. Select the button to add the latest version of Cascade to your store, for free. The update installs a new, unpublished copy of Cascade that won’t affect your live store.

Cascade theme on the Shopify Theme Store with a button to Add latest theme version.

Didn't edit the code?

If you don’t recall making changes to the code, and Cascade does not update automatically, perhaps the code was edited by a support advisor or expert, at your request, or was modify by installing an app.

# Transfer sections and settings

When you update Cascade from Theme store, the update installs a new, unpublished copy of Cascade in your store’s Admin. This new copy is a “blank state”, without your homepage sections, settings or code edits.

The following describes how to get your homepage sections, and most of your theme settings, into a newly updated theme quickly.

A few caveats

Please note this procedure does not move your code edits over, including app installations. Code edits need to be moved over manually, if you made code edits yourself. If the edits were made by a third-party developer or theme customization service, contact them for assistance. If the edits were part of an app installation, repeat the app installation steps after completing this guide.

If your copy of Cascade is considerably older than the version you’re installing, it’s possible that the settings have changed and this process will fail. If the update process fails, consider starting “from scratch” and re-configure the new version of Cascade to match your old version.

Complete the following steps to copy the sections and settings from an older version of Cascade to a new version.

# Back up your theme

  1. Create a backup of the new Cascade theme. Refer to Shopify help: Duplicating themes (opens new window)

    (Optional) Create a backup of the old theme.

    This ensures you have backups if something goes wrong.

# Transfer settings data

  1. Open your old (current) Cascade theme in Code editor.

    Note

    To open your current theme in Code editor:

    • Go to Online Store > Themes
    • In the Current theme area, select the Actions dropdown
    • From the dropdown menu, select Edit code
    Editorial theme in the Online Store section of the Shopify Admin with the Actions drop-down menu expanded.
  2. In Code editor’s sidebar, find the file named settings_data.json.

    To access the file, you might need to expand the Config directory.

  3. Select and copy the file’s contents.

    Make sure you select everything, including the opening and closing braces.

    Important!

    Make sure you’re working with the file settings_data.json. Do not copy the file settings_schema.json.

    theme's settings data JSON file open in the Shopify theme code editor.
  4. Go to the Themes area of your store’s Admin, and then find the new version of Cascade.

  5. Open the new Cascade theme in Code editor, and then find the file settings_data.json.

  6. Select the file’s contents and paste over it with the content you copied previously.

    Ensure you replace the entire contents of the file.

  7. Save the file.

# Transfer section and block settings

  1. Open your old Cascade theme in Code editor.

  2. In Code editor’s sidebar, locate and expand the Templates directory.

    The Templates directory in Code editor
  3. Note the JSON files listed with a blue circle icon.

    This icon indicates modified or updated JSON files.

    A blue circle icon that indicates a modified JSON file in Code editor
  4. Select a JSON file that’s listed with a blue icon.

    Note the name of the JSON file.

    Note

    You’ll repeat the following steps for each JSON file that has a blue circle icon.

  5. Select and copy the file’s contents.

    JSON file content selected in Code editor for copying
  6. Go to the Themes area of your store’s admin, and then find the new version of Cascade.

  7. Open the new version of Cascade in Code editor.

  8. In Code editor, locate and expand the Templates directory.

  9. Select a JSON file with the same name as the file you copied from previously.

  10. Overwrite the file’s contents by pasting the content you copied from the old theme.

    JSON file content selected in Code editor for copying
  11. Save the file.

  12. Repeat Steps 4 to 11 for each file that’s listed in your old theme with a blue icon.

Good job! Your new version of Cascade now has the same settings and homepage sections as your previous version 😃