Home Original page

Liquid support | Scriban

  1. Home
  2. Docs
  3. Liquid support

Scriban supports all the core liquid syntax types, operators, tags and filters.

Known issues

Supported types

Liquid types are translated to the same types in scriban:

The nil value (which can't be expressed in liquid) is equivalent to the expression null in scriban.

  • array are also supported, except that scriban allows to create arrays directly from the language unlike liquid

In addition to this, scriban supports the creation of an object

Supported operators

Liquid supports only conditional expressions and they directly translate to conditionnal expressions in scriban.

In addition to this, scriban supports:

In the following sections, you will find a list of the supported liquid tags and how scriban translates a liquid template into a scriban template.

Variable and properties accessors

Liquid Scriban
{% assign variable = 1 %} {{ variable = 1 }}
{{ variable }} {{ variable }}
{{ my-handle }} {{ this["my-handle" }}
{{ page.title }} {{ page.title }}
{% assign for = 5 %} {{ (for) = 5 }} (for keyword needs parenthesis in scriban)
{{ for }} {{ (for) }}
{{ products[0].title }} {{ products[0].title }}
{{ product.empty? }} {{ product.empty? }}

Liquid comment/endcomment tags translate to a code block {{ ... }} embracing a multiline comments ##

liquid

This is plain {% comment %}This is comment {% with ## some tag %} and comment{% endcomment %}

scriban

This is plain {{## This is comment {% with \#\# some tag %\} and comment ##}}

raw tag

Liquid raw tag block translate to an escape block

liquid

This is plain {% raw %}This is raw {% with some tag %} and raw{% endraw %}

scriban

This is plain This is raw {% with some tag %} and raw

assign tag

Liquid assign tag translates to a simple assignment expression

liquid

{% assign variable = 1 %}
{{ variable }}

scriban

{{ variable = 1 }}
{{ variable }}

if tag

Liquid if <expression>/endif tags translate to a if <expression>/end

liquid

{% assign variable = 1 %}
{% if variable == 1 %}
  This is a variable with 1
{% endif %}

scriban

{{ variable = 1 }}
{{ if variable == 1 }}
  This is a variable with 1
{{ end }}

unless tag

Liquid unless <expression>/endunless tags translate to a if <expression>/end with a reversed nested !(expression)

liquid

{% assign variable = 1 %}
{% unless variable == 1 %}
  This is not a variable with 1
{% endunless %}

scriban

{{ variable = 1 }}
{{ if!( variable == 1 )}}
  This is not a variable with 1
{{ end }}

case and when tags

Liquid case <variable>/when <expression>/endcase tags translate to a case <expression>/when <expression>/end

liquid

{%- assign variable = 5 -%}
{%- case variable -%}
    {%- when 6 -%}
        Yo 6
    {%- when 7 -%}
        Yo 7
    {%- when 5 -%}
        Yo 5
{% endcase -%}

scriban

{{ variable = 5 -}}
{{ case variable -}}
    {{ when 6 -}}
        Yo 6
    {{- when 7 -}}
        Yo 7
    {{- when 5 -}}
        Yo 5
{{ end }}

for tag

Liquid for <variable> in <expression>/endfor tags translate to the same for/end

liquid

{%- for variable in (1..5) -%}
    This is variable {{variable}}
{% endfor -%}

scriban

{{ for variable in (1..5) -}}
    This is variable {{variable}}
{{ end }}

tablerow tag

Liquid tablerow <variable> in <expression>/endtablerow tags translate to the same tablerow/end

liquid

{%- tablerow variable in (1..5) -%}
    This is variable {{variable}}
{% endtablerow -%}

scriban

{{ tablerow variable in (1..5) -}}
    This is variable {{variable}}
{{ end }}

capture tag

Liquid capture <variable>/endcapture tags translate to a capture <expression>/end

liquid

{%- capture variable -%}
    This is a capture
{%- endcapture -%}
{{ variable }}

scriban

{{ capture variable -}}
    This is a capture
{{- end -}}
{{ variable }}

Pipe calls

Liquid pipe call translates to the same pipe call

liquid

{% assign test = "abcdef" %}
{{ test | truncate: 5 }}

scriban

{{ test = "abcdef" }}
{{ test |  string.truncate 5 }}

As you can notice, Scriban will translate a call to a liquid tag to the corresponding scriban tag. But scriban also provides supports for direct tags calls using the LiquidTemplateContext. See liquid support in runtime

Supported filters

By default, all liquid filters are translated to scriban builtin functions (through objects like string or array)

The translation is performed by the TryLiquidToScriban function at parsing time.

This translation can be disabled by setting the ParserOptions.LiquidFunctionsToScriban to false

Converting liquid to scriban using liquid2scriban

If you compile this repository, you will find a tool liquid2scriban that allows to convert a liquid script to scriban.

The liquid2scriban has one option that allows to parse Jekyll liquid templates that are passing to the include directive raw strings without quotes (e.g {% include /this/is/partial.html %}) In that case, you can pass the option --relaxed-include to liquid2scriban, to allow the convertor to recognize this parameter as an implicit string instead.