Skip to content

Migrate to using color schemes

This guide describes how to bring your Cascade version 3 color schemes over to Cascade 4's new color schemes format.

The Color scheme Theme settings for Cascade 4 in Theme editor.

Important

Version 4 of Cascade theme uses Shopify's new color schemes. The new color schemes offer advantages over the custom color schemes we used for version 3 of Cascade theme.

Cascade 3 and Cascade 4 use different data formats to implement color schemes. A consequence of using different data formats is that colors from your store's color schemes do not migrate automatically when you update your Cascade theme from version 3 to version 4.

Use the Color scheme migrator tool

To help you bring your existing color schemes over to the new color schemes format, we made the online Color scheme migrator tool.

To use the Color scheme migrator tool, complete the following steps.

Note

Before you edit your theme code, duplicate your current theme. Refer to Shopify help: Duplicating themes.

Duplicating your theme retains a backup copy of your current theme in your Shopify admin. If something unexpected happens to your store after you edit your theme code, use your duplicated theme to revert your changes.

  1. In your Shopify admin, navigate to Sales channels > Online store > Themes.

  2. In the Themes area, locate your Cascade version 3 theme.

  3. Update your Cascade version 3 theme to the latest version.

    Refer to Update to latest version. The update process creates a new copy of Cascade in your Shopify admin's Theme library. Your new copy of Cascade is updated to the latest version, without the colors from your store's color schemes.

  4. In your Shopify admin Themes > Theme library area, locate your newly updated copy of Cascade created by the update process.

  5. Beside the name of your newly updated copy of Cascade, select ... (the ellipsis icon), and then choose Edit code.

    Selecting the Edit code option opens Shopify's Code editor.

    The ellipsis icon selected in Shopify admin.

  6. In Code editor, expand the Config subdirectory.

  7. Inside the Config subdirectory, select the settings_data.json file.

    A file open in the Shopify Code editor.

  8. With the settings_data.json file open in a Code editor tab, select the entire contents of the file, and then copy the file's contents to your computer's clipboard.

    In the following steps, you will paste the copied file contents into the Color scheme migrator tool. Keep the file open in Code editor, you will edit the code in the following steps.

    A file open in the Shopify Code editor with the copy option selected.

  9. In a new web browser window or tab, open the Color scheme migrator tool.

  10. On the Color scheme migrator page, select Paste to paste the settings_data.json file contents into the tool.

    Alternatively, locate the Color scheme migrator's first text box (on the left side). Then, in the tool's first text box, paste the settings_data.json file contents that you copied previously.

    The Color scheme migrator web page with the Paste option selected.

  11. After you paste your data, the contents of the tool's second text box update automatically (on the right side).

    After the contents of the tool's second text box have updated, select Copy to copy the contents of the tool's second text box to your computer's clipboard. In the following steps, you will paste the data you copied into Shopify's Code editor.

    Note

    If the tool's second text box shows an error message, follow the instructions displayed on the web page. Alternatively, contact the Switch support team for help.

    The Color scheme migrator web page with the Copy option selected.

  12. Return to your previous browser window or tab that has the settings_data.json file open in Shopify's Code editor.

    If you closed Code editor, reopen the file in Code editor.

  13. In the Code editor pane, select the entire contents of the settings_data.json file.

  14. Replace the file's contents by pasting the data that you copied from the Color scheme migrator tool.

  15. Select Save, and then preview your store to verify that your color schemes have migrated successfully.

  16. After you finish customizing, publish your updated theme from your Shopify admin.

    The publish theme option selected in Shopify admin.