# Update to latest version

We update Shapes’ code regularly. Our updates provide Shapes 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, Shapes updates automatically (unless the theme code was edited). If the theme code was edited, you must install updates manually by following this guide.

# Update Shapes manually

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

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

Screenshot of the Shapes 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 Shapes 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 Shapes from Theme Store, the update installs a new, unpublished copy of Shapes 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 Shapes 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 Shapes to match your old version.

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

# Back up your theme

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

  2. (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) Shapes theme in Code editor.

    Note

    To open a theme in Code editor:

    • Go to Online Store > Themes.
    • In the Current theme/ Theme library area, select (the ellipsis icon).
    • From the dropdown menu, select Edit code.
    Screenshot of the Shapes theme, in the Online Store section of the Shopify Admin, with the Actions dropdown menu expanded.
  2. In Code editor’s sidebar, expand the Config folder, and then select the file named settings_data.json.

    Screenshot of the config folder in Code editor.
  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 Shapes.

  5. Open the new Shapes 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 Shapes theme in Code editor.

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

  3. Note the JSON files listed with a circle icon.

    This icon indicates modified or updated JSON files.

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

    Note the name of the JSON file.

    Note

    You’ll repeat the following steps for each JSON file that has a 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 Shapes.

  7. Open the new version of Shapes 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 pasting.
  11. Save the file.

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

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