‘missing template “layout/theme.liquid”‘ Error When Uploading Custom Shopify Theme
I’ve been working on my first e-commerce project with Shopify over the past week. As a result I’ve have had the joy of learning their ‘liquid’ templating language whilst creating a new bespoke Shopify theme.
In order to upload a theme, you first need to get the folder structure in place with the required .liquid files. These prerequisites are described in the documentation found here:
Taking from the page above, it states that the required default theme structure needs to contain the following files and folders:
After spending a few hours constructing these, I was then ready to upload the theme. You can see below my folder structure which matches the list above from the documentation:
I then zipped everything up, went to upload the theme, and in doing so received the following error:
As you can see, I’m getting the error:
Upload Theme does not contain all required files: missing template "layout/theme.liquid"
From the list of required folder/files above you can see that the folder names begin with capital letters, yet in the error message produced it’s asking for everything in lowercase.
It was this that lead to me try and rename the folders to match the error message. After renaming the folders to be lowercase I was then able to upload the theme successfully.
I personally think the Shopify documentation is a little misleading here when it comes to the naming of the folders as it gives the folder names capitilised and nowhere does it mention they should be in lowercase.
Fortunately the fix was an easy one. Hopefully this will help you if you too have fallen into this trap.