Theme Development: Liquid Syntax Error: Unknown Tag 'Schema'

Topic summary

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.

Hi guys!

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.

If the picture doesn’t work, here is the code:

{% schema %}
{
“name”: “Product Options”,

“settings”: [
{
“id”: “prod-opt”,
“type”: “text”,
“label”: “Add a Product Options Dashboard”
}
],

“templates”: [
“index”,
“page”,
“product”
]
}

{% endschema %}


Thanks :slightly_smiling_face: Have a good day!

3 Likes

hi @Charles51 ,

The cause you doing creating on templates folders. If you want create the new section you need move the file to sections folder

If you want any help regarding technical, don’t hesitate contact with me. Thank you!

Hi!

Thank you so much for your answer! I knew it was a rookie mistake!

hi @Charles51 ,

if my suggestion helpful to you, can you please like and checked as accepted solution, thank!

I am facing the same issue in app theme extension
[blocks/star_rating.liquid] Liquid syntax error (line 11): Unknown tag ‘schema’
any luck?

8 Likes

Same here ..i dont know what should i do..did you get any idea??

4 Likes

Hello, seems like it’s an issue from Shopify side, bump this up for their attentions

3 Likes

Same issue here, can’t believe they’re doing the parsing online lol

3 Likes

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.

There’s a shopify dev community thread with more people reporting the problem. I tried to file an issue on github and it sent me there.

Same here. unable to deploy

Please give me the solution to this problem

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

:cross_mark: Error
10:19:25 │ om-custom-cart │ └ [blocks/mini-cart-app-embed.liquid] Liquid syntax error (line 229): Unknown tag ‘schema’

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 am getting a similar error: Liquid syntax error (line 216): Unknown tag ‘schema’

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

i getting same error when i want to trying run my app.

10:56:32 │ app-preview │ :cross_mark: Error
10:56:32 │ bundleblockextension │ └ [blocks/app-embed.liquid] Liquid syntax error (line 5): Unknown tag ‘schema’
10:56:32 │ bundleblockextension │ └ [blocks/bundle_collection.liquid] Liquid syntax error (line 5): Unknown tag ‘schema’
10:56:32 │ bundleblockextension │ └ [blocks/proxy-block.liquid] Liquid syntax error (line 26): Unknown tag ‘schema’
10:56:32 │ bundleblockextension │ └ [blocks/star_rating.liquid] Liquid syntax error (line 11): Unknown tag ‘schema’

im getting the same problem but cant find the solution

Same here :laughing: , Looks like shopify is having issues