Home > Shopify Tutorials > Find the problem in your theme code

How to find the problem in your Shopify theme code

Last updated: September 01, 2024
Written and researched by experts at AvadaLearn more about our methodology

By Sam Nguyen

CEO Avada Commerce

Want to fix issues in your Shopify store but don’t know where to start? Many store owners struggle to find problems in their Shopify theme code. This guide will show you how to pinpoint and solve these issues quickly. We’ll walk you through simple steps to find the problem in your Shopify theme code, even if you’re not a tech expert. By the end, you’ll have the skills to keep your store running smoothly and looking great.

Find the problem in your theme code

Step 1: Press on the .liquid file

The warning message comes up to notify you that there is some error in your theme setting. Press on the .liquid file which is linked in that message to go directly to the incorrect file.

Step 2: Look for the error

This is a list I’ve prepared for you about errors you might have. Take an overview and see what exactly the error is.

  • The code is without a closing tag or an opening tag: For example, it needs to have both of the opening <div> tag and closing </div> tag.
  • Malformed HTML tags: For example, the code <div class=”my-class” without a >

  • Use the same id: On a web page, the class can be used multiple times but you can only use the id for a particular element. This is especially important when applying javascript, ajax.

For example, this is the wrong use:

<div id = "idabc"> Information </div> <div id = "idabc"> Other information </div>

It need to be correct like this:

<div id = "infomation"> Information </div> <div id = "otherinfo"> Other information </div>
  • The closing tag in the wrong order: It is really important that the closing tag in the right location, for example, the div tag is only closed after all the tags in it are closed.

Wrong:

<div><strong>Information</div> </strong>

Correct:

<div><strong>Information</strong> </div>
  • Capitalize tags: You will not validate your HTML code if you write the following:
<DIV> </DIV>
  • Use special characters: Make sure that you use special characters correctly in HTML code because the browser can not always understand and handle them. For example:

Wrong:

<p> ©, & Stuff </p>

Correct:

<p> & copy ;, & amp; Stuff </p>

Step 3: Fix the error

You must have found your problem. In this step, make sure to correct the code by fixing the error.

Step 4: Tap on Save

Finally, tap on Save to save your change.

Step 5: Select Customize{#select-customize}

If you want to confirm there is not any error exist, select Customize to return to the theme editor. If the message is still shown, there must be some error need to be fixed. If it’s not, you’ve corrected all the error.

Summary

Finding and fixing problems in your Shopify theme code doesn’t have to be daunting. By following these steps, you can quickly identify and resolve issues, keeping your store running smoothly. Take action now: start by carefully reviewing your .liquid files and applying the error-checking tips we’ve shared. With practice, you’ll become more confident in maintaining your Shopify theme. Remember, a well-functioning theme is key to providing a great shopping experience for your customers.


Sam Nguyen is the CEO and founder of Avada Commerce, an e-commerce solution provider headquartered in Singapore. He is an expert on the Shopify e-commerce platform for online stores and retail point-of-sale systems. Sam loves talking about e-commerce and he aims to help over a million online businesses grow and thrive.