For loops

Last updated:

For loops can be used in HubL to iterate through sequences of objects. They will most commonly be used with rendering blog content in a listing format, but they can also be used to sort through other sequence variables.

For loops begin with a {% for %} statement and end with an {% endfor %} statement. Within the {% for %} statement a single sequence item is named followed by in and then the name of the sequence. The code between the opening and closing for statements is printed with each iteration, and generally includes the printed variable of the individual sequence item. Below is the basic syntax of a for loop:

{% for item in items %}
	{{ item }}
{% endfor %}
Below is a basic example that shows how to print a sequence of variable values into a list.
{% set languages = ['HTML', 'CSS', 'Javascript', 'Python', 'Ruby', 'PHP,', 'Java'] %}

    {% for language in languages %}
    <li>{{ language }}</li>
    {% endfor %}

Loop properties

As a loop iterates, you can use conditional logic to define the loop's behavior. The variable property loop.index keeps a count of the current number of the iterations of the loop. There are several other loop variable properties that count the iterations in different ways. These properties are described below:

A helper function to cycle between a list of sequences. See the explanation below.


Indicates how deep in deep in a recursive loop the rendering currently is. Starts at level 1


Indicates how deep in deep in a recursive loop the rendering currently is. Starts at level 0


This variable evaluates to true, if it is the first iteration of the loop.


The current iteration of the loop. This variable starts counting at 1.


The current iteration of the loop. This variable starts counting at 0.


This variable evaluates to true, if it is the last iteration of the loop.


The number of items in the sequence.


The number of iterations from the end of the loop. Counting down to 1.


The number of iterations from the end of the loop. Counting down to 0.

Below are some examples that use different loop variables. The following basic example uses loop.index to keep a count that is printed with each iteration.

{% set loopy = ['Content', 'Social', 'Contacts', 'Reports'] %}
{% for app in loopy %}
    {{ loop.index }}. {{app}} <br>
{% endfor %}

The next example uses conditional logic to check whether the length of the loop is divisibleby certain numbers. It then renders the width of the post-item div accordingly. The example uses the standard blog post loop and assumes that there are 6 posts in the loop.

{% for content in contents %}
{% if loop.length is divisibleby 4 %}
<div style="width:25%">Post content</div>

{% elif loop.length is divisibleby 3 %}
<div style="width:33.33332%">Post content</div>

{% else %}
<div style="width:50%">Post content</div>

{% endif %}
{% endfor %}

Nested loops

Loops can also be nested with loops. The child for loop will run with each iteration of the parent for loop. In the example below, a list of child items is printed in a nested <ul> within a <ul> of parent items.

{% set parents = ['Parent item 1', 'Parent item 2', 'Parent item 3'] %}
{% set children = ['Child item 1', 'Child item 2', 'Child item 3'] %}
{% for parent in parents %}
    {% for child in children %}
    {% endfor %}
{% endfor %}


The cycle tag can be used within a for loop to cycle through a series of string values and print them with each iteration. One of the most practical applications to this technique is applying alternating classes to your blog posts in a listing. This tag can be used on more than two values and will repeat the cycle if there are more loop iterations than cycle values. In the example below, a class of odd and even are applied to posts in a listing (the example assumes that there are 5 posts in the loop).  

Please note that there are no spaces between the comma-separated cycle string values.

{% for content in contents %}
    <div class="post-item {% cycle 'odd','even' %}">Blog post content</div>
{% endfor %}

Variables within loops

Any variables defined within loops are limited to the scope of that loop and cannot be called from outside of the loop.

You can call variables that are defined outside of a loop, from within a loop, but not the other way around.

Key, value pairs in loops

If the dict of information you are looping through has key and value pairs, a simple for loop would only have access to the values. If you wish to have access to both the keys and values within the for loop, the HubL would be formatted as such:

{% set dict_var = {'name': 'Cool Product', 'price': '$20', 'size':'XL'} %}
{% for key, val in dict_var.items() %}
    {{ key }}: {{ val }}<br>
{% endfor %}

Iterate a set number of times

Sometimes you want to iterate a set number of times, this can be useful in generating HTML or CSS. You can do this using the range function.

{% for x in range(0,5) %}
{% endfor %}

Using HubL tags in loops

When you add a tag to page HubSpot automatically assigns an id to the wrapping HTML. That tag is unique per tag "name". In situations where you need to use a tag in a for loop setting unique names is not practical. Add the unique_in_loop parameter to your tag to generate unique ids. This parameter appends the module name with the current loop iteration number, ensuring that it is unique. Unique id's are not only needed for valid HTML but are important for accessibility

{% for item in module.icon_field %}
	{% icon
		name="{{ }}",
		style="{{ item.type }}",
		unicode="{{ item.unicode }}",
{% endfor %}

Was this page helpful? *
This form is for feedback on our developer docs. If you have feedback on the HubSpot product, please share it in our Idea Forum instead.