Troubleshooting

Overview

Troubleshooting common issues in the theme editor helps you keep your store running smoothly and ensures you are making full use of all our modern features. The following sections provide solutions to frequent problems and step-by-step guidance to resolve them quickly.

💡 Tip: If you experience any challenges while customizing your theme, review these steps first — they often save you time and help avoid frustration.

Page is redirecting to an unsupported URL

If your storefront redirects to URLs not connected to your shop, this is often due to custom code or an app. This can cause interruptions when editing with the theme editor.

1. Review your theme files or installed apps for any redirect code that may cause unwelcome behavior.

2. Make sure redirects are disabled while editing by using the window.Shopify.designMode variable.

   1. This variable is set to true when the store is open in the editor, and false otherwise.

   2. Referencing this variable lets you stop redirects so your editing is not interrupted.

⚠️ Important: Always disable any redirects that interfere with your experience in the editor while working on your theme.

Page failed to load due to an error

If a page fails to load in the theme editor, this usually means there is a problem with your connection or code.

1. Check for a reliable internet connection — a weak signal can interrupt your editing session.

2. Look for invalid Liquid code — errors in custom code can stop the page from loading.

If you've checked these and the page still fails to load:

1. Preview your store through Theme actions > Preview theme.

2. If you still can’t load the page, consider reaching out to support for further help.

HTML error found

An HTML error found warning means there is a syntax issue in your code. Fixing these problems keeps your theme robust and fully functional.

1. Open the .liquid file flagged in the error message.

2. Look for syntax errors — the code editor usually highlights these in red.

3. Watch for common mistakes, such as:

   1. Extra or missing HTML tags, like mismatched <div> elements or missing closing >.

   2. Broken Liquid code, such as missing curly braces.

   3. Syntax issues inside theme snippets.

Steps to fix code problems

Follow these steps to fix code and resolve errors:

1. Open the .liquid file listed in the error inside your code editor.

2. Review the code for the types of mistakes listed above.

3. Correct any errors to ensure your HTML and Liquid syntax is valid.

4. Click Save to apply your changes.

5. Select Customize to return to the editor and verify the problem is resolved.

Other solutions

If these tips do not address your issue, try the following:

1. Roll back your theme to a previous version to recover earlier functionality.

2. Download and install the latest version of the theme for access to the newest features.

3. Contact support to discuss what help is available for your theme.

📝 Note: Regularly save your work and test changes as you go. This helps prevent persistent issues and makes troubleshooting simpler.