Unknown tag 'schema'

Shopify Apps

Topic summary

Issue: After a routine restart (npm run dev), a previously working Shopify app extension now throws an “Unknown tag ‘schema’” Liquid error.

Context and environment:

  • Tooling versions: shopify-cli 3.85.5, Node 20.19.4, npm 10.8.2.
  • User is new to Shopify app development; the project had been functioning before today.

What was tried:

  • Deleted node_modules and reinstalled dependencies (including @shopify/react-router mention), but the error persists.

Relevant code and setup:

  • app-block.liquid and app-embed.liquid both include Liquid {% schema %} … {% endschema %} blocks defining JSON (name, target, javascript: “hurry-timer.min.js”, settings: ).
  • A minimal JS file (hurry-timer.min.js) is referenced.
  • Screenshot provided appears central to understanding the exact error output.

Open questions / status:

  • Root cause of Liquid parsing “Unknown tag ‘schema’” is unresolved.
  • Whether this stems from environment/tooling changes, file placement, or extension configuration is unclear; no fix identified yet.
Summarized with AI on December 16. AI used: gpt-5.
1

I’m new to Shopify app development, and my project was running perfectly fine until today. However, after restarting the project today (npm run dev), it started throwing errors, even after all the changes I made. I tried deleting node_modules.shopify.react-router and reinstalling it with npm, but the problem persists.

shopify-cli 3.85.5
node 20.19.4
npm 10.8.2

hurry-timer.min.js
(function (){console.log('hello extension')})();

app-block.liquid
<div data-hurry-timer-container>
  123
</div>
{% schema %}
{
  "name": "Countdown timer",
  "target": "section",
  "javascript": "hurry-timer.min.js",
  "settings": []
}
{% endschema %}

app-embed.liquid
<script type="text/javascript">
  
</script>
{% schema %}
{
  "name": "Countdown timer",
  "target": "body",
  "javascript": "hurry-timer.min.js",
  "settings": []
}
{% endschema %}

1
11293×516 32.8 KB

2

Today I also encountered the same problem

3

I’ve now updated shopify-cli to 3.88.1, created a new project using shopify app init, generated the extension using shopify app generate extension, and then run npm run dev. It’s throwing the error again: [blocks/star_rating.liquid] Liquid syntax error (line 11): Unknown tag