Skip to content

Latest commit

 

History

History
36 lines (28 loc) · 1.21 KB

liquid.md

File metadata and controls

36 lines (28 loc) · 1.21 KB
Raw
title permalink
Liquid Options
/docs/configuration/liquid/

Liquid's response to errors can be configured by setting error_mode. The options are

  • lax --- Ignore all errors.
  • warn --- Output a warning on the console for each error.
  • strict --- Output an error message and stop the build.

Within _config.yml, this could be configured as follows:

liquid:
  error_mode: warn

You can also configure Liquid's renderer to catch non-assigned variables and non-existing filters by setting strict_variables and / or strict_filters to true respectively. {% include docs_version_badge.html version="3.8.0" %}

Do note that while error_mode configures Liquid's parser, the strict_variables and strict_filters options configure Liquid's renderer and are consequently, mutually exclusive.

An example of setting these variables within _config.yml is as follows:

liquid:
  error_mode strict
  strict_variables: true
  strict_filters: true

Configuring as described above will stop a build/serve from happening and instead call out the offending error and halt. This is helpful when desiring to catch liquid-related issues by stopping the build or serve process and forcing you to deal with it.