Utility

comment

Allows you to leave un-rendered code inside a Liquid template. Any text within the opening and closing comment blocks will not be printed, and any Liquid code within will not be executed.

Input

{% assign verb = "turned" %}
{% comment %}
{% assign verb = "converted" %}
{% endcomment %}
Anything you put between {% comment %} and {% endcomment %} tags
is {{ verb }} into a comment.

Output

Anything you put between  tags
is turned into a comment.

Inline comments

You can use inline comments to prevent an expression from being rendered or output. Any text inside of the tag also won’t be rendered or output.

You can create multi-line inline comments. However, each line must begin with a #.

Input

{% # for i in (1..3) -%}
  {{ i }}
{% # endfor %}

{%
  ###############################
  # This is a comment
  # across multiple lines
  ###############################
%}

Output

raw

Temporarily disables tag processing. This is useful for generating certain content that uses conflicting syntax, such as Mustache or Handlebars.

Input

{% raw %}
In Handlebars, {{ this }} will be HTML-escaped, but {{{ that }}} will not.
{% endraw %}

Output

In Handlebars, {{ this }} will be HTML-escaped, but {{{ that }}} will not.

include

The include tag is deprecated; please use render instead.

Insert the rendered content of another template within the current template.

{% include "template-name" %}

The include tag works similarly to the render tag, but it allows the code inside of the rendered template to access and overwrite the variables within its parent template. It has been deprecated because the way that it handles variables reduces performance and makes Liquid code harder to both read and maintain.

Note that when a template is rendered using the render tag, the include tag cannot be used within the template.