Liquid Objects: Details

• Resources
• Standard Insites content
• Functional elements that help build interactivity.

Objects might represent a single data point or contain multiple properties. Some properties might represent a related object, such as a product in a category or collection of products.

We cover the following most commonly-used objects on Insites, namely:

• forloop
• tablerowloop

forloop

The forloop object is available inside a tag. It exposes metadata about the current state of the loop iteration.

This section discusses the following usage examples of the forloop object:

• forloop.first
• forloop.index
• forloop.index0
• forloop.last
• forloop.length
• forloop.rindex
• forloop.rindex0

In these examples, is an array, for example the results of a GraphQL query.

forloop.first

Returns true if it's the first iteration of the loop. Returns false if it is not the first iteration.

Input

{% for product in products %}
  {% if forloop.first == true %}
    First time through!
  {% else %}
    Not the first time.
  {% endif %}
{% endfor %}

Output

First time through!
Not the first time.
Not the first time.
Not the first time.
Not the first time.

forloop.index

Returns the current index of the loop, starting at 1.

Input

{% for product in products %}
  {{ forloop.index }}
{% else %}
  // no products
{% endfor %}

Output

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

forloop.index0

Returns the current index of the loop, starting at 0.

Input

{% for product in products %}
  {{ forloop.index0 }}
{% endfor %}

Output

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

forloop.last

Returns true if it's the last iteration of the loop. Returns false if it is not the last iteration.

Input

{% for product in products %}
  {% if forloop.last == true %}
    This is the last iteration!
  {% else %}
    Keep going...
  {% endif %}
{% endfor %}

Output

Keep going...
Keep going...
Keep going...
Keep going...
Keep going...
This is the last iteration!

forloop.length

Returns the number of iterations of the loop.

Input

{% comment %} if products contains 4 products {% endcomment %}
{% for product in products %}
  {% if forloop.first %}
  <p>This collection has {{ forloop.length }} products:</p>
  {% endif %}
  <p>{{ product.title }}</p>
{% endfor %}

Output

This collection has 4 products:
Apple
Orange
Peach
Plum

forloop.rindex

Returns in reverse order.

Input

{% for product in products %}
  {{ forloop.rindex }}
{% endfor %}

Output

16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1

forloop.rindex0

Returns in reverse order.

Input

{% for product in products %}
  {{ forloop.rindex0 }}
{% endfor %}

Output

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0

tablerowloop

The tablerow object is used within the tag. It contains attributes of its parent loop. This section discusses the following examples:

• tablerowloop.length
• tablerowloop.index
• tablerowloop.index0
• tablerowloop.rindex
• tablerowloop.rindex0
• tablerowloop.first
• tablerowloop.last
• tablerowloop.col
• tablerowloop.col0
• tablerowloop.col_first
• tablerowloop.col_last

tablerowloop.length

Returns the number of iterations of the loop.

tablerowloop.index

Returns the current index of the loop, starting at 1.

tablerowloop.index0

Returns the current index of the loop, starting at 0.

tablerowloop.rindex

Returns in reverse order.

tablerowloop.rindex0

Returns in reverse order.

tablerowloop.first

Returns if it's the first iteration of the loop. Returns if it is not the first iteration.

tablerowloop.last

Returns if it's the last iteration of the loop. Returns if it is not the last iteration.

tablerowloop.col

Returns the index of the current column, starting at 1.

tablerowloop.col0

Returns the index of the current column, starting at 0.

tablerowloop.col_first

Returns if the current column is the first column in a row, returns if it is not.

tablerowloop.col_last

Returns if the current column is the last column in a row, returns if it is not.