File checks

Last updated Oct 6, 2026 View as Markdown

Snippets and layouts are now checked for Liquid syntax errors when you save them. Locales are checked against the locale format.
If a save is rejected, you get a 422 with {"errors": [{"file", "line", "key", "message", "severity"}]}. You get the same body from the code editor, the theme editor and theme dev. Before, the body was different on each of them.
In the code editor, errors in Liquid and JSON files are marked on their line while you type.
In the theme editor, the settings and the template are both checked before either one is saved.
A theme upload is checked file by file before any file is saved. If one file has an error, the upload is rejected with the errors of all files.

Required files

layout/theme.liquid and the index, product, collection, list-collections, page, cart, search, thankyou and upsell templates are required.
A theme upload without one of them is rejected with the list of missing files.
You cannot delete a required file in the code editor or with theme dev.

Use {% doc %} to document a snippet or a block. Its content is not parsed or rendered. See doc.