Troubleshooting
If you are experiencing issues with your theme editor, then check if your issue appears below.
Common issues
Issue: Failed to load the page
Page is redirecting to an unsupported URL
If your storefront includes code that redirects users to URLs that are not connected to your shop, then verify that the redirect has been disabled when you visit the theme editor.
For example, this type of redirect might be added to a storefront to direct buyers to different Shopify stores depending on their location. This type of redirect code could exist in either your theme or an app that you installed.
To ensure your redirect doesn't interfere with the editor experience, use a reference to thewindow.Shopify.designMode
variable in JavaScript to disable the redirect when you visit the theme editor. This variable is set totrue
when the storefront is loaded in the editor, andfalse
when it isn't.
Page failed to load due to an error
A page can fail to load in the theme editor for many reasons. Common issues include the following:
- network connection issues
- invalid Liquid code in your theme
If you have verified that these issues are not causing the error, then try visiting your online store by navigating toTheme actions>Preview themein the theme editor. If the page fails to load, then you cancontact Shopify supportfor help with your storefront.
HTML error found
When making changes to your theme settings in thetheme editor, you might see an 'HTML error found' warning message in the editor:
This error message appears when a syntax error is found in your theme code. To resolve the problem, you can examine the code in the Liquid file that is referenced in the error message. In the example above, this would be theslideshow.liquid
.
Finding the problem in your theme code
- Click the
.liquid
section file that is linked to in the error message. This will take you to theEdit HTML/CSS page, and the file will open in the code editor. - Look through the code in the file and try to find invalid HTML or Liquid. The code editor will show potential syntax errors in red. Common problems include the following:
- Extra closing HTML tags, for example, a closing
- Extra closing HTML tags, for example, a closing