# Update to latest version

We update Baseline's code regularly. Our updates provide Baseline with new and improved features, important security enhancements, and the latest bug fixes. Refer to Shopify help: Updating themes.

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

Update Baseline manually

To update Baseline manually, go to the Baseline theme page on Theme Store.

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

Screenshot of the Cascade theme on the Shopify Theme Store with an Add latest theme version button

Didn't edit the code?

If you don't recall making changes to the code, and Baseline 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 Baseline from Theme Store, the update installs a new, unpublished copy of Baseline 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 Baseline 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 Baseline to match your old version.

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

Back up your theme

  1. Create a backup of the new Baseline theme. Refer to Shopify help: Duplicating themes.

    (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) Baseline 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

    Screenshot of the 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.

    Screenshot of a 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 Baseline.

  5. Open the new Baseline 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 Baseline theme in Code editor.
  2. In Code editor's sidebar, locate and expand the Templates directory.

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

  5. This icon indicates modified or updated JSON files.

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

  7. Note the name of the JSON file.

    Note

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

  8. Select and copy the file's contents.

  9. JSON file content selected in Code editor for copying
  10. Go to the Themes area of your store's admin, and then find the new version of Baseline.

  11. Open the new version of Baseline in Code editor.

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

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

  14. Overwrite the file's contents by pasting the content you copied from the old theme.

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

  17. 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 Baseline now has the same settings and homepage sections as your previous version 😃