LiquidSyntaxError

Identifies invalid Liquid syntax in tags, raw tags, branches, variable output, and parser errors. This check reports unknown tags, misplaced branch keywords, invalid raw tag markup, unclosed raw tags, and other Liquid syntax errors.

Fix syntax errors so Theme Check and Shopify can parse the file consistently.

Note

This check covers Liquid tag and output syntax. For HTML markup errors, see LiquidHTMLSyntaxError.

Anchor to ExamplesExamples

The following examples contain code snippets that either fail or pass this check.

Anchor to ✗ Fail✗ Fail

In the following example, the {% liquid %} tag contains an unknown tag named hello:

{% liquid

hello world

Anchor to ✓ Pass✓ Pass

In the following example, the branch keywords are used inside tags that support them:

{% if product.available %}

Available

{% else %}

Unavailable

{% endif %}

{% case product.type %}

{% when 'Snowboard' %}

Snowboard

{% else %}

Product

{% endcase %}

Anchor to OptionsOptions

The following example contains the default configuration for this check:

LiquidSyntaxError:

enabled: true

severity: error

Parameter	Description
`enabled`	Whether this check is enabled.
`severity`	The severity of the check.

Anchor to Disabling this checkDisabling this check

Disabling this check isn't recommended.

Was this page helpful?