Issue: Liquid error “Unknown tag ‘schema’” when adding a new .liquid section to a Shopify theme.
Key cause and fix:
The file containing the {% schema %}…{% endschema %} block was created under the templates folder.
Moving the file to the sections folder resolved the error, since the schema tag is only valid in section (and block) files, not templates.
Status/outcome:
Original poster confirmed it was a placement mistake and thanked the responder.
A request was made to mark the answer as the accepted solution.
New update/unresolved:
Another user reports the same error in an app theme extension at blocks/star_rating.liquid (line 11). No solution or follow-up guidance has been provided yet, so this part remains open.
Notes:
Screenshots were shared to illustrate the error and folder structure; helpful but not required to understand the fix.
Summarized with AI on December 16.
AI used: gpt-5.
I’m trying to create a new section for my shopify store. I created a new .liquid file, and when I try to sync the following code to my github repository, I really can’t manage to find why I get the Liquid Syntax Error: Unknown Tag ‘Schema’ error.
Same issue here.
node v22.15.0 @shopify/cli v3.88.1.
Tried rolling back shopify cli and node versions but the error persists. Tried ignoring the error with .theme-check.yml, and I’m able to pass ‘shopify theme check’ but I still have the same error when running shopify app dev.
Same issue here. I haven’t upgraded the version of Shopify. Today, when I opened the project, it couldn’t run. It was working fine a few days ago.
My current version: @shopify/cli: 3.88.1
Getting the error after moving this to section folder got this on deploying it Your theme app extension includes files in an unsupported directory, sections │
│ │
│ Make sure all theme app extension files are in the supported directories: assets, blocks, locales, snippets │
│
I’m getting the following error from Shopify’s side during shopify app preview, even though the build succeeds:
This is happening inside a Theme App Extension.
post-purchase-extension builds successfully
Error appears only for theme-app-extension during preview
Files affected are under extensions/theme-app-extension/blocks/*.liquid