Troubleshooting

Featured links

1. Shopify documentation on troubleshooting your online store theme
2. Shopify documentation on creating and managing URL redirects
3. Shopify admin theme editor
4. Shopify documentation on editing theme code
5. Shopify documentation on editing theme code
6. Shopify documentation on theme support

When you customize Align in the Shopify theme editor, use the steps below to resolve common editor and storefront issues. For Align-specific guidance, start with the Company XYZ documentation and contact Company XYZ support. For additional Shopify platform troubleshooting, see Shopify’s theme troubleshooting reference

Page redirects to an unsupported URL

Check for storefront code that redirects visitors to a URL that is not connected to your shop. Disable the redirect while you are using the Shopify theme editor.

For example, a storefront might redirect customers to different stores based on their location. This redirect code might be part of your Align theme customizations or an installed app.

To prevent the redirect from interrupting the editor, use the window.Shopify.designMode variable in JavaScript to disable the redirect in the theme editor. This variable is true when the storefront loads in the editor and false when it does not.

For redirect setup details, see Shopify documentation on creating and managing URL redirects

Page fails to load

A page can fail to load in the theme editor for several reasons, including:

1. Network connection issues.
2. Invalid Liquid code in your theme.

If you have ruled out these causes, open your storefront from the theme editor by selecting Theme actions > Preview theme. If the page also fails to load in preview, the issue affects the storefront beyond the editor; contact Shopify Support for help with the Shopify platform or your storefront.

HTML error found

An HTML error found warning in the theme editor usually means there is a syntax error in your theme code. Review the Liquid file named in the error message to locate and correct the issue.

For code-editing details, see Shopify documentation on editing theme code

Find the problem in your theme code

1. Select the linked .liquid section file in the error message. The file opens in the Edit HTML/CSS page.

2. Review the file for invalid HTML or Liquid. The code editor highlights potential syntax errors in red.

   Common issues include:

   • An extra closing HTML tag, such as </div> without an opening <div>.
   • An unclosed HTML tag, such as an opening <div> without a closing </div>.
   • A malformed HTML tag, such as <div class="my-class" without a closing >.
   • Malformed Liquid code.
   • Broken HTML in an included theme snippet file.

3. Correct the problem in the theme file.

4. Select Save.

5. Select Customize to return to the theme editor and confirm that the warning is gone.

Other solutions

If the issue continues after you have tried the steps above, consider these options:

1. Roll back to an older version of your theme file
2. Review the support available for your theme. For help with Align-specific behavior or configuration, contact Company XYZ support.

Usage notes

1. Test redirects in the editor. Make sure any redirect that sends visitors away from your shop is disabled while you customize Align.
2. Use preview to isolate loading issues. If a page fails in both the editor and theme preview, the issue likely affects the storefront rather than the editor alone.
3. Follow the error message. Start with the file linked by an HTML warning, then use the highlighted code to narrow down the problem.
4. Save and recheck. Return to Customize after each correction to confirm the error has been resolved.