Troubleshooting

Debugging version problems

0. This assumes that neither of the two following configurations are set in settings.json.

   • "shopifyLiquid.languageServerPath"
   • "shopifyLiquid.shopifyCLIPath"

Note If both are set, "shopifyLiquid.languageServerPath" takes priority.

1. Determine the version of theme check used by your terminal. In a terminal, run the following two commands.

shopify theme check --version
theme-check --version

2. Enable language server logs by setting the following configuration in your settings.json:

{
  "shopifyLiquid.trace.server": "verbose",
}

3. Restart the theme-check server.

   

4. Check the 'Theme Check Language Server' logs of the Output tab:

   

5. Search for serverInfo (cmd/ctrl+f, should be at the top of the logs).

6. Compare with the results from step 1. If the results are not the same, consider setting one of the two configurations presented in step 0. to the path of the correct executable.

   {
     // preferred
     "shopifyLiquid.languageServerPath": "<result of `which theme-check-language-server`>",
     // alternative
     "shopifyLiquid.shopifyCLIPath": "<result of `which shopify`>"
   }

   On Linux or macOS, the path would be the result of the which command. In a terminal, you'd run the following:

   $ which theme-check-language-server
   /Users/username/.gem/ruby/2.6.6/bin/theme-check-language-server

   And you'd paste the result in the shopifyLiquid.languageServerPath settings.json config. e.g.

   {
     "shopifyLiquid.languageServerPath": "/Users/username/.gem/ruby/2.6.6/bin/theme-check-language-server",
   }

   On Windows, you'd use the output of the where.exe command. In a terminal, you'd run the following:

   C:\> where theme-check-language-server
   C:\Ruby-x64\bin\theme-check-language-server.bat

   Note that you'll need to escape the backslashes in your settings.json file.

   {
     "shopifyLiquid.languageServerPath": "C:\\Ruby-x64\\bin\\theme-check-language-server.bat",
   }